Funzione SetupDiGetClassImageListExA (setupapi.h)

  • Articolo

La funzione SetupDiGetClassImageListEx compila un elenco di immagini di bitmap per ogni classe installata in un sistema locale o remoto.

Sintassi

WINSETUPAPI BOOL SetupDiGetClassImageListExA(
  [out]          PSP_CLASSIMAGELIST_DATA ClassImageListData,
  [in, optional] PCSTR                   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 Le icone specifiche della classe in un computer remoto possono essere visualizzate solo se la classe è presente anche nel computer locale. Pertanto, se il computer remoto ha classe X, ma la classe X non è installata in locale, verrà restituita l'icona generica (sconosciuta).
 

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

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

Vedi anche

SetupDiDestroyClassImageList

SetupDiGetClassImageList