SetupDeleteError function

[This function is available for use in the operating systems indicated in the Requirements section. It may be altered or unavailable in subsequent versions. SetupAPI should no longer be used for installing applications. Instead, use the Windows Installer for developing application installers. SetupAPI continues to be used for installing device drivers.]

The SetupDeleteError function generates a dialog box that informs the user of a delete error.

Syntax


UINT SetupDeleteError(
  _In_  HWND   hwndParent,
  _In_  PCTSTR DialogTitle,
  _In_  PCTSTR File,
  _Out_ UINT   Win32ErrorCode,
  _In_  DWORD  Style
);

Parameters

hwndParent [in]

Handle to the parent window for this dialog box.

DialogTitle [in]

Optional pointer 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 [in]

Pointer to a null-terminated string specifying the full path of the file on which the delete operation failed.

Win32ErrorCode [out]

The system error code encountered during the file operation.

Style [in]

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 value

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Setupapi.h

Library

Setupapi.lib

DLL

Setupapi.dll

Unicode and ANSI names

SetupDeleteErrorW (Unicode) and SetupDeleteErrorA (ANSI)

See also

Overview
Functions
SetupCopyError
SetupPromptForDisk
SetupRenameError

 

 

Show: