SetupDiGetINFClassW-Funktion (setupapi.h)
Die funktion SetupDiGetINFClass gibt die Klasse einer angegebenen Geräte-INF-Datei zurück.
Syntax
WINSETUPAPI BOOL SetupDiGetINFClassW(
[in] PCWSTR InfName,
[out] LPGUID ClassGuid,
[out] PWSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] InfName
Ein Zeiger auf eine MIT NULL beendete Zeichenfolge, die den Namen einer INF-Datei eines Geräts angibt. Dieser Name kann einen Pfad enthalten. Wenn jedoch nur der Dateiname angegeben ist, wird die Datei in jedem Verzeichnis gesucht, das im DevicePath- eintrag unter dem Eintrag HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion Unterschlüssel der Registrierung aufgeführt ist. Die maximale Länge in Zeichen, einschließlich eines NULL-Terminators, eines NULL-beendeten INF-Dateinamens ist MAX_PATH.
[out] ClassGuid
Ein Zeiger auf eine Variable vom Typ GUID, die die Klassen-GUID für die angegebene INF-Datei empfängt. Wenn die INF-Datei keinen Klassennamen angibt, gibt die Funktion eine GUID_NULL Struktur zurück. Rufen Sie SetupDiClassGuidsFromName- auf, um zu ermitteln, ob mindestens eine Klasse mit diesem Namen bereits installiert ist.
[out] ClassName
Ein Zeiger auf einen Puffer, der eine MIT NULL beendete Zeichenfolge empfängt, die den Namen der Klasse für die angegebene INF-Datei enthält. Wenn die INF-Datei keinen Klassennamen angibt, aber eine GUID angibt, empfängt dieser Puffer den Namen, der durch Aufrufen SetupDiClassNameFromGuidabgerufen wird. Wenn SetupDiClassNameFromGuid jedoch keinen Klassennamen abrufen kann (z. B. wird die Klasse nicht installiert), wird eine leere Zeichenfolge zurückgegeben.
[in] ClassNameSize
Die Größe des Puffers, auf den der ClassName-Parameter verweist, in Zeichen. Die maximale Länge eines NULL-beendeten Klassennamens in Zeichen ist MAX_CLASS_NAME_LEN.
[out, optional] RequiredSize
Ein Zeiger auf eine DWORD-Typvariable, die die Anzahl der Zeichen empfängt, die zum Speichern des Klassennamens erforderlich sind, einschließlich eines endenden NULL-. Dieser Zeiger ist optional und kann NULL-sein.
Rückgabewert
Die Funktion gibt TRUE- zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE- zurückgegeben, und der protokollierte Fehler kann mit einem Aufruf von GetLastErrorabgerufen werden.
Bemerkungen
Verwenden Sie diese Funktion nicht mit INF-Dateien für Windows 9x oder Millennium Edition.
Anmerkung
Der Header setupapi.h definiert SetupDiGetINFClass 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 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 |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | setupapi.h (include Setupapi.h) |
| Library | Setupapi.lib |
| API-Satz | ext-ms-win-setupapi-classinstallers-l1-1-2 (eingeführt in Windows 10, Version 10.0.14393) |