SetupUninstallOEMInfA-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 SetupUninstallOEMInf-Funktion deinstalliert eine angegebene INF-Datei und alle zugehörigen PNF-Dateien. Wenn die INF-Datei mit einem Katalog zum Signieren von Treibern installiert wurde, wird der Katalog ebenfalls entfernt. Ein Aufrufer dieser Funktion muss über Administratorrechte verfügen, andernfalls schlägt die Funktion fehl.

Syntax

WINSETUPAPI BOOL SetupUninstallOEMInfA(
  [in] PCSTR InfFileName,
  [in] DWORD Flags,
  [in] PVOID Reserved
);

Parameter

[in] InfFileName

Dateiname ohne Pfad der INF-Datei im Windows Inf-Verzeichnis, das deinstalliert werden soll.

[in] Flags

Dieser Parameter kann wie folgt festgelegt werden.

Flag	Bedeutung
SUOI_FORCEDELETE 0x0001	Die SetupUninstallOEMInf-Funktion überprüft zunächst mithilfe der INF-Datei, ob Geräte installiert sind. Ein Gerät muss nicht vorhanden sein, um mit der INF-Datei erkannt zu werden. Wenn dieses Flag nicht festgelegt ist und die Funktion ein aktuell installiertes Gerät findet, das mit dieser INF-Datei installiert wurde, wird die INF-Datei nicht entfernt. Wenn dieses Flag festgelegt ist, wird die INF-Datei entfernt, unabhängig davon, ob die Funktion ein Gerät findet, das mit dieser INF-Datei installiert wurde. Hinweis Dieses Flag gilt nur für x86-, amd64- und ia64-Architekturen. Sie wird in allen anderen Architekturen ignoriert. Hinweis Wenn das Treiberpaket Dateien enthält, die in einen DestinationDir kopiert werden, der eine DirId von 13 verwendet, wird dieses Erzwingungsflag ignoriert. Hinweis Es wird empfohlen, diUninstallDriver zu verwenden, um ein Treiberpaket zu entfernen, anstatt dieses Flag zu verwenden.

Flag

Bedeutung

SUOI_FORCEDELETE
0x0001

Die SetupUninstallOEMInf-Funktion überprüft zunächst mithilfe der INF-Datei, ob Geräte installiert sind. Ein Gerät muss nicht vorhanden sein, um mit der INF-Datei erkannt zu werden.

Wenn dieses Flag nicht festgelegt ist und die Funktion ein aktuell installiertes Gerät findet, das mit dieser INF-Datei installiert wurde, wird die INF-Datei nicht entfernt.

Wenn dieses Flag festgelegt ist, wird die INF-Datei entfernt, unabhängig davon, ob die Funktion ein Gerät findet, das mit dieser INF-Datei installiert wurde.

Hinweis Dieses Flag gilt nur für x86-, amd64- und ia64-Architekturen. Sie wird in allen anderen Architekturen ignoriert.

Hinweis Wenn das Treiberpaket Dateien enthält, die in einen DestinationDir kopiert werden, der eine DirId von 13 verwendet, wird dieses Erzwingungsflag ignoriert.

Hinweis Es wird empfohlen, diUninstallDriver zu verwenden, um ein Treiberpaket zu entfernen, anstatt dieses Flag zu verwenden.

[in] Reserved

Auf NULL festgelegt.

Rückgabewert

Diese Funktion gibt WINSETUPAPI BOOL zurück.

Hinweise

Hinweis

Der Setupapi.h-Header definiert SetupUninstallOEMInf 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
APIs	ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393)

Siehe auch

Share via