SetupDiBuildClassInfoList-Funktion (setupapi.h)

  • Artikel

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

Weitere Informationen

SetupDiBuildClassInfoListEx

SetupDiGetClassDescription

SetupDiGetINFClass