SetupBackupErrorA-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 zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. SetupAPI wird weiterhin zum Installieren von Gerätetreibern verwendet.]

Die SetupBackupError-Funktion generiert ein Dialogfeld, das den Benutzer über einen Sicherungsfehler informiert.

Syntax

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

Parameter

[in] hwndParent

Handle zum übergeordneten Fenster für dieses Dialogfeld.

[in] DialogTitle

Optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den Fehlerdialogfeldtitel angibt. Wenn dieser Parameter NULL ist, wird der Standardtitel "Backup Error" (lokalisiert) verwendet.

[in] SourceFile

Zeiger auf eine NULL-endende Zeichenfolge, die den vollständigen Pfad der Quelldatei angibt, die gesichert wird.

[in] TargetFile

Optionaler Zeiger auf eine NULL-endende Zeichenfolge, die den vollständigen Pfad des Sicherungsnamens der Datei angibt. Dieser Parameter kann NULL sein.

[out] Win32ErrorCode

Wenn ein Fehler auftritt, ist dieser Member der Systemfehlercode. Wenn kein Fehler aufgetreten ist, wird er NO_ERROR.

[in] Style

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

IDF_NOBEEP

Verhindern Sie, dass das Dialogfeld piept, um die Aufmerksamkeit des Benutzers zu erhalten, wenn es zum ersten Mal angezeigt wird.

IDF_NOFOREGROUND

Verhindern Sie, 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 SetupBackupError 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 Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen


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