Download demo project - 23 Kb
Download source files - 9 Kb <!-- Article Starts -->
CShellFileOp class is designed to be an easy-to-use wrapper for the Win32
SHFileOperation() API. This function is powerful, but using it requires lots of bookkeeping.
CShellFileOp hides the complex details of the API, and instead lets the programmer use familiar C++ constructs. It also does extensive error-checking of the parameters you use. This decreases headaches, reduces the amount of time the programmer loses wading through the docs, and in general makes everyone happy.
CShellFileOp was written with MSVC 5.0 and tested with 6.0. The sample project is now in 6.0 format. I have also tested it in Unicode on NT 4.
Example - Using CShellFileOp to copy files
Below is example code showing the way
SHFileOperation(). I have included complete documentation for the class in each of the zip files accompanying this article. The docs are in the file
sfo.AddSourceFile ( _T("c:\\windows\\command\\format.com") );
sfo.AddSourceFile ( _T("c:\\windows\\command\\fdisk.exe") );
sfo.AddSourceFile ( _T("c:\\*.com") );
sfo.AddDestFile ( _T("A:\\") );
// Set up a few flags that control the operation.
( FO_COPY, // the operation type (copy in this case)
AfxGetMainWnd(), // pointer to parent window
FALSE, // flag - silent mode?
FALSE, // flag - allow undo?
FALSE, // flag - should wild cards affect files only?
TRUE, // flag - suppress confirmation messages?
TRUE, // flag - suppress confirmation messages
// when making directories?
FALSE, // flag - rename files when name collisions occur?
FALSE ); // flag - simple progress dialog?
// Start the operation.
if ( sfo.Go ( &bAPICalled, &nAPIReturnVal ) )
// The operation succeeded!
if ( !bAPICalled )
// SHFileOperation() wasn't called - check the info you passed
// in to the CShellFileOp object. The DEBUG version will
// throw ASSERTs and/or show TRACE messages to help you out.
// SHFileOperation() returned nonzero (failure). That return
// value is now in nAPIReturnVal.
October 11, 1998: Version 1.0. First release.
February 27, 2000: Version 1.1. Fixed a bug in
CShellFileOp::Go() that allocated too much memory in Unicode builds.
You can get the latest updates to this and my other articles at http://home.inreach.com/mdunn/code/