Funzione SHGetStockIconInfo (shellapi.h)

Articolo
03/01/2024

Recupera informazioni sulle icone della shell definite dal sistema.

Sintassi

SHSTDAPI SHGetStockIconInfo(
            SHSTOCKICONID   siid,
            UINT            uFlags,
  [in, out] SHSTOCKICONINFO *psii
);

Parametri

siid

Tipo: SHSTOCKICONID

Uno dei valori dell'enumerazione SHSTOCKICONID che specifica quale icona deve essere recuperata.

uFlags

Tipo: UINT

Combinazione di zero o più flag seguenti che specificano le informazioni richieste.

SHGSI_ICONLOCATION

I membri szPath e iIcon della struttura SHSTOCKICONINFO ricevono il percorso e l'indice icona dell'icona richiesta, in un formato adatto per il passaggio alla funzione ExtractIcon . Il valore numerico di questo flag è zero, quindi si ottiene sempre la posizione dell'icona indipendentemente dagli altri flag.

SHGSI_ICON

Il membro hIcon della struttura SHSTOCKICONINFO riceve un handle per l'icona specificata.

SHGSI_SYSICONINDEX

Il membro iSysImageImage della struttura SHSTOCKICONINFO riceve l'indice dell'icona specificata nell'elenco immagini di sistema.

SHGSI_LINKOVERLAY

Modifica il valore SHGSI_ICON facendo in modo che la funzione aggiunga la sovrimpressione del collegamento all'icona del file.

SHGSI_SELECTED

Modifica il valore SHGSI_ICON causando la fusione dell'icona con il colore di evidenziazione del sistema da parte della funzione.

SHGSI_LARGEICON

Modifica il valore SHGSI_ICON determinando che la funzione recupera la versione grande dell'icona, come specificato dalle metriche di sistema SM_CXICON e SM_CYICON.

SHGSI_SMALLICON

Modifica il valore SHGSI_ICON causando il recupero della versione ridotta dell'icona da parte della funzione, come specificato dalle metriche di sistema SM_CXSMICON e SM_CYSMICON.

SHGSI_SHELLICONSIZE

Modifica i valori di SHGSI_LARGEICON o SHGSI_SMALLICON facendo in modo che la funzione recuperi le icone di dimensioni della shell anziché le dimensioni specificate dalle metriche di sistema.

[in, out] psii

Tipo: SHSTOCKICONINFO*

Puntatore a una struttura SHSTOCKICONINFO . Quando questa funzione viene chiamata, il membro cbSize di questa struttura deve essere impostato sulle dimensioni della struttura SHSTOCKICONINFO . Quando termina, questa funzione contiene un puntatore a una struttura SHSTOCKICONINFO contenente le informazioni richieste.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se questa funzione restituisce un handle di icona nel membro hIcon della struttura SHSTOCKICONINFO a cui punta psii, l'utente è responsabile della liberazione dell'icona con DestroyIcon quando non è più necessaria.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shellapi.h
DLL	Shell32.dll
Set di API	ext-ms-win-shell-shell32-l1-2-1 (introdotto in Windows 10, versione 10.0.10240)

Condividi tramite