Funzione SetupDiLoadClassIcon (setupapi.h)

  • Articolo

La funzione SetupDiLoadClassIcon carica sia l'icona grande che quella minima per la classe specificata.

Sintassi

WINSETUPAPI BOOL SetupDiLoadClassIcon(
  [in]            const GUID *ClassGuid,
  [out, optional] HICON      *LargeIcon,
  [out, optional] PINT       MiniIconIndex
);

Parametri

[in] ClassGuid

Puntatore al GUID della classe per cui devono essere caricate le icone.

[out, optional] LargeIcon

Puntatore a un handle di icona che riceve il valore dell'handle per l'icona grande caricata per la classe specificata. Questo puntatore è facoltativo e può essere NULL. Se il puntatore è NULL, l'icona grande non viene caricata.

[out, optional] MiniIconIndex

Puntatore a una variabile tipizzata INT che riceve l'indice dell'icona mini per la classe specificata. L'icona mini viene archiviata nella cache mini-icona del programma di installazione del dispositivo. Il puntatore è facoltativo e può 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 da una chiamata a GetLastError.

Commenti

Le icone della classe sono predefinite e caricate dalla cache interna del programma di installazione del dispositivo oppure vengono caricate direttamente dall'eseguibile del programma di installazione della classe. Questa funzione esegue una query sul valore del Registro di sistema ICON nella sezione della classe specificata. Se viene specificato il valore ICON , indica quale mini-icona caricare.

Se il valore ICON è negativo, il valore assoluto rappresenta un'icona predefinita nel Registro di sistema della classe. Per un elenco delle mini icone predefinite, vedere SetupDiDrawMiniIcon .

Se il valore ICON è positivo, rappresenta un'icona nell'immagine eseguibile del programma di installazione della classe che verrà estratta. Il valore 1 è riservato. Questa funzione usa anche il valore del Registro di sistema INSTALLER32 e quindi il valore del Registro di sistema ENUMPROPPAGES32 per determinare l'immagine eseguibile da cui estrarre le icone. Per altre informazioni su questi valori del Registro di sistema, vedere la sezione INF ClassInstall32.

Al termine dell'uso dell'icona, il chiamante deve chiamare DestroyIcon (descritto nella documentazione di Microsoft Windows SDK).

Se viene specificato il parametro LargeIcon , ma il parametro ClassGuid non fornisce un GUID di classe valido o il valore del Registro di sistema Icon della classe non è valido, SetupDiLoadClassIcon carica l'icona grande predefinita, restituisce l'handle per l'icona grande e, se viene specificato il parametro MiniIconIndex , restituisce l'indice dell'icona mini predefinita.

Requisiti

   
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
DLL Setupapi.dll

Vedi anche

SetupDiDrawMiniIcon

SetupDiGetClassBitmapIndex