SPFILENOTIFY_COPYERROR

The SPFILENOTIFY_COPYERROR notification is sent to the callback routine if an error occurs during a file copy operation.

SPFILENOTIFY_COPYERROR
    Param1 = (UINT) FilePathInfo;
    Param2 = (UINT) ReturnBuffer;
 

Parameters

Param1
Pointer to a FILEPATHS structure.
Param2
Pointer to a buffer, of size MAX_PATH TCHAR elements, that stores new path information specified by the user.

Return Values

The callback should return one of the following values.

Value Meaning
FILEOP_ABORT Queue processing should be cancelled. SetupCommitFileQueue returns zero and GetLastError returns extended error information such as ERROR_CANCELLED (if the user canceled) or ERROR_NOT_ENOUGH_MEMORY.
FILEOP_NEWPATH Retry the copy operation using the path the callback function placed in the buffer pointed to by the Param2 parameter. The callback routine should ensure that the path does not overflow the buffer size of a TCHAR array of MAX_PATH elements.
FILEOP_RETRY The user chose to attempt the the copy operation again.
FILEOP_SKIP The user chose to skip the file copy operation.

QuickInfo

  Windows NT: Use version 4.0 and later.
  Windows: Use Windows 95 and later.
  Windows CE: Unsupported.
  Header: Declared in setupapi.h.

See Also

Overview, Notifications, FILEPATHS, SetupCommitFileQueue, SetupDefaultQueueCallback