Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

SetupRenameError 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 RenameError function generates a dialog box that informs the user of a file renaming error.

Syntax


UINT SetupRenameError(
  _In_  HWND hwndParent,
  _In_  PCTSTR DialogTitle,
  _In_  PCTSTR SourceFile,
  _In_  PCTSTR TargetFile,
  _In_  UINT Win32ErrorCode,
  _In_  DWORD Style
);

Parameters

hwndParent [in]

Handle to the parent window for this dialog box.

DialogTitle [in]

Pointer to a null-terminated string that specifies the error dialog box title. This parameter may be NULL. If this parameter is NULL, the default title of "Rename Error" (localized) is used.

SourceFile [in]

Pointer to a null-terminated string that specifies the full path of the source file on which the operation failed.

TargetFile [in]

Pointer to a null-terminated string that specifies the full path of the target file on which the operation failed.

Win32ErrorCode [in]

The system error code encountered during the file operation.

Style [in]

Specifies 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 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 on the Cancel button.

DPROMPT_SKIPFILE

The user clicked on 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 [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Setupapi.h

Library

Setupapi.lib

DLL

Setupapi.dll

Unicode and ANSI names

SetupRenameErrorW (Unicode) and SetupRenameErrorA (ANSI)

See also

Overview
Functions
SetupCopyError
SetupDeleteError
SetupPromptForDisk

 

 

Community Additions

ADD
Show:
© 2015 Microsoft