SetupUninstallOEMInfA-Funktion (setupapi.h)

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

[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

Funktionen

Übersicht

SetupCopyOEMInf

DiUninstallDriver