SetupUninstallOEMInfW-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 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 SetupUninstallOEMInf-Funktion deinstalliert eine angegebene INF-Datei und alle zugeordneten 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 SetupUninstallOEMInfW(
[in] PCWSTR 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 |
---|---|
|
Die SetupUninstallOEMInf-Funktion überprüft zunächst mithilfe der INF-Datei, ob Geräte installiert sind. Ein Gerät muss nicht vorhanden sein, um bei Verwendung der INF-Datei erkannt zu werden.
Wenn dieses Flag nicht festgelegt ist und die Funktion ein aktuell installiertes Gerät findet, das mithilfe dieser INF-Datei installiert wurde, wird die INF-Datei nicht entfernt. Wenn dieses Flag festgelegt ist, wird die INF-Datei entfernt, wenn 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 ein DestinationDir kopiert werden, das die DirId 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
Legen Sie auf NULL fest.
Rückgabewert
Diese Funktion gibt WINSETUPAPI BOOL zurück.
Hinweise
Hinweis
Der setupapi.h-Header definiert SetupUninstallOEMInf 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 |
APIs | ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393) |
Siehe auch
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für