Funzione SetupDiLoadClassIcon (setupapi.h)
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 |