Funzione SHDefExtractIconA (shlobj_core.h)

Fornisce un gestore predefinito per estrarre un'icona da un file.

Sintassi

SHSTDAPI SHDefExtractIconA(
  [in]            LPCSTR pszIconFile,
                  int    iIndex,
  [in]            UINT   uFlags,
  [out, optional] HICON  *phiconLarge,
  [out, optional] HICON  *phiconSmall,
                  UINT   nIconSize
);

Parametri

[in] pszIconFile

Tipo: LPCTSTR

Puntatore a un buffer con terminazione null contenente il percorso e il nome del file da cui viene estratta l'icona.

iIndex

Tipo: int

Percorso dell'icona all'interno del file denominato in pszIconFile. Se si tratta di un numero positivo, si riferisce alla posizione in base zero dell'icona nel file. Ad esempio, 0 fa riferimento all'icona 1st nel file di risorse e 2 fa riferimento al 3°. Se si tratta di un numero negativo, si riferisce all'ID risorsa dell'icona.

[in] uFlags

Tipo: UINT

Flag che controlla l'estrazione dell'icona.

GIL_SIMULATEDOC

Sovrappone l'icona estratta nell'icona del documento predefinito per creare l'icona finale. Questa icona può essere usata quando non è possibile trovare o recuperare un'icona più appropriata.

[out, optional] phiconLarge

Tipo: HICON*

Puntatore a un HICON che, quando questa funzione restituisce correttamente, riceve l'handle della versione large dell'icona specificata in LOWORD di nIconSize. Questo valore può essere NULL.

[out, optional] phiconSmall

Tipo: HICON*

Puntatore a un HICON che, quando questa funzione restituisce correttamente, riceve l'handle della versione piccola dell'icona specificata nell'HIWORD di nIconSize.

nIconSize

Tipo: UINT

Valore che contiene le dimensioni dell'icona di grandi dimensioni nel relativo LOWORD e le dimensioni dell'icona di piccole dimensioni nel relativo HIWORD. Le dimensioni sono misurate in pixel. Passare 0 per specificare dimensioni grandi e piccole predefinite.

Valore restituito

Tipo: HRESULT

Questa funzione può restituire uno di questi valori.

Commenti

È responsabilità del chiamante liberare le risorse dell'icona create tramite questa funzione quando non sono più necessarie. Questa operazione può essere eseguita tramite la funzione DestroyIcon .

Requisiti