Funzione SetupDiGetClassImageListExW (setupapi.h)

Articolo
11/20/2024

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 relative all'elenco di immagini di 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 a stringa con terminazione NULL che fornisce il nome di un sistema remoto per le cui classi SetupDiGetClassImageListEx deve compilare bitmap. Questo parametro è facoltativo e può essere NULL. Se MachineName è NULL, SetupDiGetClassImageListEx compila l'elenco per il sistema locale.

Cautela

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 ha esito positivo, la funzione restituisce TRUE. In caso contrario, restituisce FALSE e l'errore registrato può essere recuperato da una chiamata a GetLastError.

Osservazioni

L'elenco di immagini creato da questa funzione deve essere eliminato definitivamente chiamando SetupDiDestroyClassImageList.

Nota 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 dispone di classe X, ma la classe X non è installata localmente, 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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

Vedere anche

SetupDiDestroyClassImageList

SetupDiGetClassImageList

Condividi tramite