SHFILEOPSTRUCT

Original link: http://winapi.freetechsecrets.com/win32/WIN32SHFILEOPSTRUCT.htm

Reference linke: SHFileOperation方法拷贝文件

Contains information that the SHFileOperation function uses to perform file operations.

typedef struct _SHFILEOPSTRUCT { // shfos

HWND hwnd;

UINT wFunc;

LPCSTR pFrom;

LPCSTR pTo;

FILEOP_FLAGS fFlags;

BOOL fAnyOperationsAborted;

LPVOID hNameMappings;

LPCSTR lpszProgressTitle;

} SHFILEOPSTRUCT, FAR *LPSHFILEOPSTRUCT;

Members

hwnd

Handle of the dialog box to use to display information about the status of the operation.

wFunc

Operation to perform. This member can be one of the following values:

pFrom

Pointer to a buffer that specifies one or more source file names. Multiple names must be null-separated. The list of names must be double null-terminated.

pTo

Pointer to a buffer that contains the name of the destination file or directory. The buffer can contain mutiple destination file names if the fFlags member specifies FOF_MULTIDESTFILES. Multiple names must be null-separated. The list of names must be double null-terminated.

fFlags

Flags that control the file operation. This member can be a combination of the following values:

fAnyOperationsAborted

Value that receives TRUE if the user aborted any file operations before they were completed or FALSE otherwise.

hNameMappings

Handle of a filename mapping object that contains an array of SHNAMEMAPPING structures. Each structure contains the old and new path names for each file that was moved, copied, or renamed. This member is used only if fFlags includes FOF_WANTMAPPINGHANDLE.

lpszProgressTitle

Pointer to a string to use as the title for a progress dialog box. This member is used only if fFlags includes FOF_SIMPLEPROGRESS.

Remarks

If pFrom or pTo are unqualified names, the current directories are taken from the global current drive and directory settings as managed by the GetCurrentDirectory and SetCurrentDirectory functions.

See Also

GetCurrentDirectory, SetCurrentDirectory, SHFileOperation, SHFreeNameMappings, SHNAMEMAPPING

__________________________________________________________________________________________

Example:

Copy a file to a specific path and rename it.

    TCHAR* chFrom =_T("C:\\TEST\\A\\gg.txt");

    TCHAR* chTo=_T("C:\\TEST\\B\\gg.txt");

    TCHAR* chNewName=_T("C:\\TEST\\B\\new.txt");

    SHFILEOPSTRUCT shFileOp;

    ZeroMemory(&shFileOp, sizeof(SHFILEOPSTRUCT));

    shFileOp.wFunc=FO_COPY;

    shFileOp.pFrom=chFrom+'\0';

    shFileOp.pTo=chTo+'\0';

    shFileOp.fFlags=FOF_NOCONFIRMATION|FOF_SILENT;

    DWORD dwCopyValue= SHFileOperation (&shFileOp);

    //char buffer[32];

    //ltoa((long)dwCopyValue, buffer, 10);

    char procID[];

    sprintf(procID, "%d",dwCopyValue);

    if(dwCopyValue!=)

    {

       CString strMessage;

return dwCopyValue;

    }

    shFileOp.wFunc=FO_RENAME+'\0';

    shFileOp.pFrom=chTo+'\0';

    shFileOp.pTo=chNewName+'\0';

    DWORD dwRenameValue= SHFileOperation (&shFileOp);

    if(dwRenameValue!=)

    {

        MessageBox(NULL, _T("The rename operation failed, error code is ! "+dwRenameValue), _T("Alert"), MB_OK);

        return dwRenameValue;

    }

Possible error code:

Go to this link System Error Codes to see what each code means.

1) SHFileOperation returns 124

124 means:

ERROR_INVALID_LEVEL

124 (0x7C)

The system call level is not correct.

DE_INVALIDFILES       

0x7C

The path in the source or destination or both was invalid.

Make sure the source or destination path is valid.

2) SHFileOperation returns 2

ERROR_FILE_NOT_FOUND

2 (0x2)

The system cannot find the file specified.

Make sure the file being operated exists.