Funzione SetupDiBuildClassInfoListExA (setupapi.h)
La funzione SetupDiBuildClassInfoListEx restituisce un elenco di GUID della classe di installazione che include ogni classe installata nel sistema locale o in un sistema remoto.
Sintassi
WINSETUPAPI BOOL SetupDiBuildClassInfoListExA(
[in] DWORD Flags,
[out, optional] LPGUID ClassGuidList,
[in] DWORD ClassGuidListSize,
[out] PDWORD RequiredSize,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parametri
[in] Flags
Flag utilizzati 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 di valore NoInstallClass nella relativa 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 un buffer che riceve un elenco di GUID della classe di installazione.
[in] ClassGuidListSize
Fornisce il numero di GUID nella matrice ClassGuildList .
[out] RequiredSize
Puntatore a una variabile che riceve il numero di GUID restituiti. Se questo numero è maggiore delle dimensioni di ClassGuidList, il numero indica la dimensione della matrice ClassGuidList per contenere l'elenco.
[in, optional] MachineName
Puntatore a una stringa con terminazione NULL contenente il nome di un computer remoto da cui recuperare le classi di installazione installate. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, questa funzione compila un elenco di classi installate nel computer locale.
Attenzione
L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.
Reserved
Deve essere NULL.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato effettuando una chiamata a GetLastError.
Commenti
Nota
L'intestazione setupapi.h definisce SetupDiBuildClassInfoListEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |