Funzione SetupDiGetClassImageListExW (setupapi.h)
La funzione SetupDiGetClassImageListEx compila un elenco di immagini di bitmap per ogni classe installata in un sistema locale o remoto.
Sintassi
WINSETUPAPI BOOL SetupDiGetClassImageListExW(
[out] PSP_CLASSIMAGELIST_DATA ClassImageListData,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Parametri
[out] ClassImageListData
Puntatore a una struttura SP_CLASSIMAGELIST_DATA per ricevere informazioni sull'elenco di immagini della classe, incluso un handle per l'elenco di immagini. Il campo cbSize di questa struttura deve essere inizializzato con le dimensioni della struttura, in byte, prima di chiamare questa funzione o avrà esito negativo.
[in, optional] MachineName
Puntatore alla stringa con terminazione NULL che specifica il nome di un sistema remoto per le cui classi SetupDiGetClassImageListEx deve compilare la bitmap. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, SetupDiGetClassImageListEx compila l'elenco per il sistema 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
La funzione restituisce TRUE se ha esito positivo. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.
Commenti
L'elenco di immagini compilato da questa funzione deve essere eliminato chiamando SetupDiDestroyClassImageList.
Nota
L'intestazione setupapi.h definisce SetupDiGetClassImageListEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| 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 |