SetupDiBuildClassInfoList-Funktion (setupapi.h)
Die SetupDiBuildClassInfoList-Funktion gibt eine Liste von Setupklassen-GUIDs zurück, die die Klassen identifizieren, die auf einem lokalen Computer installiert sind.
Syntax
WINSETUPAPI BOOL SetupDiBuildClassInfoList(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize
);
Parameter
[in] Flags
Flags, die verwendet werden, um den Ausschluss von Klassen aus der Liste zu steuern. Wenn keine Flags angegeben sind, sind alle Setupklassen in der Liste enthalten. Kann eine Kombination der folgenden Werte sein:
DIBCI_NOINSTALLCLASS
Schließen Sie eine Klasse aus, wenn sie den Werteintrag NoInstallClass im Registrierungsschlüssel enthält.
DIBCI_NODISPLAYCLASS
Schließen Sie eine Klasse aus, wenn sie den Werteintrag NoDisplayClass im Registrierungsschlüssel enthält.
[out, optional] ClassGuidList
Ein Zeiger auf ein GUID-typisiertes Array, das eine Liste von Setupklassen-GUIDs empfängt. Dieser Zeiger ist optional und kann NULL sein.
[in] ClassGuidListSize
Die Anzahl der GUIDs im Array, auf die der ClassGuildList-Parameter verweist. Wenn ClassGuidListNULL ist, muss ClassGuidSize 0 sein.
[out] RequiredSize
Ein Zeiger auf eine DWORD-typisierte Variable, die die Anzahl der zurückgegebenen GUIDs empfängt (wenn die Zahl kleiner oder gleich der Größe des Arrays in GUIDs ist, auf das vom ClassGuidList-Parameter verwiesen wird).
Wenn diese Zahl größer als die Größe des ClassGuidList-Arrays ist, gibt dies an, wie groß das ClassGuidList-Array sein muss, um alle Klassen-GUIDs enthalten zu können.
Rückgabewert
Die Funktion gibt TRUE zurück, wenn sie erfolgreich ist. Andernfalls wird FALSE zurückgegeben, und der protokollierte Fehler kann durch einen Aufruf von GetLastError abgerufen werden.
Hinweise
Um die Anzahl der Klassen abzurufen, die auf einem lokalen Computer installiert sind, rufen Sie SetupDiBuildClassInfoList auf, wobei ClassGuidList auf NULL und ClassGuidSize auf Null festgelegt ist. Als Reaktion auf einen solchen Aufruf gibt die Funktion die Anzahl der Klassen in *RequiredSize zurück.
SetupDiBuildClassInfoList gibt keine Klassen-GUID für eine Klasse zurück, wenn der NoUseClass-Werteintrag im Registrierungsschlüssel der -Klasse vorhanden ist.
Verwenden Sie SetupDiBuildClassInfoListEx, um die Liste der auf einem Remotesystem installierten Setupklassen-GUIDs abzurufen.
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 |
| DLL | Setupapi.dll |