SetupDeleteError
The SetupDeleteError function generates a dialog box that informs the user of a delete error.
UINT SetupDeleteError(
HWND hwndParent, // parent window for this dialog box
PCTSTR DialogTitle, // optional, title for this dialog box
PCTSTR File, // file that caused the delete error
UINT Win32ErrorCode, // specifies the error that occurred
DWORD Style // specifies formatting for the dialog box
);
Parameters
-
hwndParent
-
Handle to the parent window for this dialog box.
-
DialogTitle
-
This optional parameter points to a null-terminated string specifying the error dialog box title. If this parameter is NULL, the default title of "Delete Error" (localized) is used.
-
File
-
Pointer to a null-terminated string specifying the full path of the file on which the delete operation failed.
-
Win32ErrorCode
-
The Win32 error code encountered during the file operation.
-
Style
-
Specifies flags that control display formatting and behavior of the dialog box. This parameter can be one of the following flags:
-
IDF_NOBEEP
-
Prevent the dialog box from beeping to get the user's attention when it first appears.
-
IDF_NOFOREGROUND
-
Prevent the dialog box from becoming the foreground window.
Return Values
This function returns one of the following values:
-
DPROMPT_SUCCESS
-
The user retried the operation and it was successful.
-
DPROMPT_CANCEL
-
The user clicked the Cancel button.
-
DPROMPT_SKIPFILE
-
The user clicked the Skip File button.
-
DPROMPT_OUTOFMEMORY
-
There is insufficient memory to process the request.
To get extended error information, call GetLastError.
QuickInfo
Windows NT: Use version 4.0 and later.
Windows: Use Windows 95 and later.
Windows CE: Unsupported.
Header: Declared in setupapi.h.
Import Library: Link with setupapi.lib.
See Also
Overview, Functions, SetupCopyError, SetupPromptForDisk, SetupRenameError