SetupDeleteErrorA-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 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 SetupDeleteError-Funktion generiert ein Dialogfeld, das den Benutzer über einen Löschfehler informiert.

Syntax

WINSETUPAPI UINT SetupDeleteErrorA(
  [in]  HWND  hwndParent,
  [in]  PCSTR DialogTitle,
  [in]  PCSTR File,
  [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 "Fehler löschen" (lokalisiert) verwendet.

[in] File

Zeiger auf eine NULL-beendete Zeichenfolge, die den vollständigen Pfad der Datei angibt, für die der Löschvorgang fehlgeschlagen ist.

[out] Win32ErrorCode

Der Systemfehlercode , der während des Dateivorgangs aufgetreten ist.

[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 SetupDeleteError 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

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