SetupDiGetINFClassA-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiBuildClassInfoList

SetupDiClassGuidsFromName

SetupDiClassNameFromGuid

SetupDiGetClassDescription