Export (0) Print
Expand All
Expand Minimize

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 2000 Professional

Minimum supported server

Windows 2000 Server

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

 

 

Build date: 8/19/2010

Community Additions

ADD
Show:
© 2014 Microsoft