SetupRenameErrorA-Funktion (setupapi.h)

Artikel
08/26/2023

[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die RenameError-Funktion generiert ein Dialogfeld, das den Benutzer über einen Fehler beim Umbenennen von Dateien informiert.

Syntax

WINSETUPAPI UINT SetupRenameErrorA(
  [in] HWND  hwndParent,
  [in] PCSTR DialogTitle,
  [in] PCSTR SourceFile,
  [in] PCSTR TargetFile,
  [in] UINT  Win32ErrorCode,
  [in] DWORD Style
);

Parameter

[in] hwndParent

Handle mit dem übergeordneten Fenster für dieses Dialogfeld.

[in] DialogTitle

Zeiger auf eine NULL-beendete Zeichenfolge, die den Titel des Fehlerdialogfelds angibt. Dieser Parameter kann NULL sein. Wenn dieser Parameter NULL ist, wird der Standardtitel "Rename Error" (lokalisiert) verwendet.

[in] SourceFile

Zeiger auf eine NULL-beendete Zeichenfolge, die den vollständigen Pfad der Quelldatei angibt, für die der Vorgang fehlgeschlagen ist.

[in] TargetFile

Zeiger auf eine null-beendete Zeichenfolge, die den vollständigen Pfad der Zieldatei angibt, für die der Vorgang fehlgeschlagen ist.

[in] Win32ErrorCode

Der Während des Dateivorgangs aufgetretene Systemfehlercode .

[in] Style

Gibt die Anzeigeformatierung und das Verhalten des Dialogfelds an. Dieser Parameter kann eines der folgenden Flags sein.

IDF_NOBEEP

Verhindern Sie, dass das Dialogfeld beim ersten Mal angezeigt wird.

IDF_NOFOREGROUND

Verhindern, dass das Dialogfeld zum Vordergrundfenster wird.

Rückgabewert

Diese Funktion gibt einen der folgenden Werte zurück.

Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der setupapi.h-Header definiert SetupRenameError als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	setupapi.h
Bibliothek	Setupapi.lib
DLL	Setupapi.dll