SetupBackupErrorW-Funktion (setupapi.h)

Artikel
03/04/2024

[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 SetupBackupError-Funktion generiert ein Dialogfeld, das den Benutzer über einen Sicherungsfehler informiert.

Syntax

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

Parameter

[in] hwndParent

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

[in] DialogTitle

Optionaler Zeiger auf eine null-beendete Zeichenfolge, die den Titel des Fehlerdialogfelds angibt. Wenn dieser Parameter NULL ist, wird der Standardtitel "Sicherungsfehler" (lokalisiert) verwendet.

[in] SourceFile

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

[in] TargetFile

Optionaler Zeiger auf eine NULL-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 Formatierung und das Verhalten des Dialogfelds steuern. Dieser Parameter kann eines der folgenden Flags sein.

IDF_NOBEEP

Verhindern Sie, dass das Dialogfeld anregt, um die Aufmerksamkeit des Benutzers zu erhalten, wenn es zum 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 SetupBackupError als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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