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.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in Setupapi.h.
  Library: Use Setupapi.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

Overview, Functions, SetupCopyError, SetupPromptForDisk, SetupRenameError