SPFILENOTIFY_RENAMEERROR message

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

SPFILENOTIFY_RENAMEERROR
  Param1 = (UINT) FilePathInfo;
  Param2 = (UINT) 0;
            

Parameters

Param1

Pointer to a FILEPATHS structure. The Win32Error member of the FILEPATHS structure specifies the error that occurred during the rename operation.

Param2

Unused.

Return value

The callback routine should return one of the following.

Return code Description
FILEOP_RETRY
The user chose to attempt the rename operation again.
FILEOP_SKIP
The user chose to skip the file rename operation.
FILEOP_ABORT
Stop the queue commit. SetupCommitFileQueue returns FALSE. GetLastError returns extended error information such as ERROR_CANCELLED (if the user canceled) or ERROR_NOT_ENOUGH_MEMORY.

Requirements

Requirement Value
Minimum supported client
Windows XP [desktop apps only]
Minimum supported server
Windows Server 2003 [desktop apps only]
Header
Setupapi.h

See also

Overview

Notifications

FILEPATHS

SetupCommitFileQueue

SetupDefaultQueueCallback