Funzione SetupDiBuildClassInfoList (setupapi.h)

Articolo
08/26/2023

La funzione SetupDiBuildClassInfoList restituisce un elenco di GUID della classe di installazione che identificano le classi installate in un computer locale.

Sintassi

WINSETUPAPI BOOL SetupDiBuildClassInfoList(
  [in]            DWORD  Flags,
  [out, optional] LPGUID ClassGuidList,
  [in]            DWORD  ClassGuidListSize,
  [out]           PDWORD RequiredSize
);

Parametri

[in] Flags

Flag usati per controllare l'esclusione delle classi dall'elenco. Se non vengono specificati flag, tutte le classi di installazione vengono incluse nell'elenco. Può essere una combinazione dei valori seguenti:

DIBCI_NOINSTALLCLASS

Escludere una classe se ha la voce del valore NoInstallClass nella chiave del Registro di sistema.

DIBCI_NODISPLAYCLASS

Escludere una classe se ha la voce del valore NoDisplayClass nella relativa chiave del Registro di sistema.

[out, optional] ClassGuidList

Puntatore a una matrice tipizzata GUID che riceve un elenco di GUID dei GUID della classe di installazione. Questo puntatore è facoltativo e può essere NULL.

[in] ClassGuidListSize

Numero di GUID nella matrice a cui punta il parametro ClassGuildList . Se ClassGuidList è NULL, ClassGuidSize deve essere zero.

[out] RequiredSize

Puntatore a una variabile tipizzata DWORD che riceve il numero di GUID restituiti (se il numero è minore o uguale alla dimensione, in GUID, della matrice a cui punta il parametro ClassGuidList ).

Se questo numero è maggiore delle dimensioni della matrice ClassGuidList , indica quanto grande deve essere la matrice ClassGuidList per contenere tutti i GUID di classe.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato eseguendo una chiamata a GetLastError.

Commenti

Per recuperare il numero di classi installate in un computer locale, chiamare SetupDiBuildClassInfoList con ClassGuidList impostato su NULL e ClassGuidSize impostato su zero. In risposta a tale chiamata, la funzione restituisce il numero di classi in *RequiredSize.

SetupDiBuildClassInfoList non restituisce un GUID di classe per una classe se la voce del valore NoUseClass esiste nella chiave del Registro di sistema della classe.

Per recuperare l'elenco dei GUID della classe di installazione installati in un sistema remoto, usare SetupDiBuildClassInfoListEx.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (includere Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll