SetupDiGetINFClassA-Funktion (setupapi.h)
Die SetupDiGetINFClass-Funktion gibt die Klasse einer angegebenen Geräte-INF-Datei zurück.
Syntax
WINSETUPAPI BOOL SetupDiGetINFClassA(
[in] PCSTR InfName,
[out] LPGUID ClassGuid,
[out] PSTR ClassName,
[in] DWORD ClassNameSize,
[out, optional] PDWORD RequiredSize
);
Parameter
[in] InfName
Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen einer GeräteINF-Datei angibt. Dieser Name kann einen Pfad enthalten. Wenn jedoch nur der Dateiname angegeben wird, wird die Datei in jedem Verzeichnis gesucht, das im DevicePath-Eintrag unter dem Unterschlüssel HKLM\Microsoft\Windows\CurrentVersion der Registrierung aufgeführt ist. Die maximale Länge eines MIT NULL beendeten INF-Dateinamens in Zeichen, einschließlich eines NULL-Abschlusszeichens, 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 eine oder mehrere Klassen mit diesem Namen bereits installiert sind.
[out] ClassName
Ein Zeiger auf einen Puffer, der eine NULL-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 von SetupDiClassNameFromGuid abgerufen wird. Wenn SetupDiClassNameFromGuid jedoch keinen Klassennamen abrufen kann (z. B. ist die Klasse nicht installiert), wird eine leere Zeichenfolge zurückgegeben.
[in] ClassNameSize
Die Größe des Puffers in Zeichen, auf den der ClassName-Parameter verweist. Die maximale Länge eines MIT NULL beendeten Klassennamens in Zeichen ist MAX_CLASS_NAME_LEN.
[out, optional] RequiredSize
Ein Zeiger auf eine Variable mit DWORD-Typ, die die Anzahl von Zeichen empfängt, die zum Speichern des Klassennamens erforderlich sind, einschließlich eines beendenden 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 GetLastError abgerufen werden.
Hinweise
Verwenden Sie diese Funktion nicht mit INF-Dateien für Windows 9x oder Millennium Edition.
Hinweis
Der setupapi.h-Header definiert SetupDiGetINFClass 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 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) | Verfügbar in Microsoft Windows 2000 und höheren Versionen von Windows. |
| Zielplattform | Desktop |
| Kopfzeile | setupapi.h (einschließlich Setupapi.h) |
| Bibliothek | Setupapi.lib |