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.
Codice restituito | Descrizione |
---|---|
|
Operazione completata. |
|
L'icona richiesta non è presente. |
|
Impossibile accedere al file oppure accedere tramite un collegamento lento. |
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 .
Nota
L'intestazione shlobj_core.h definisce SHDefExtractIcon come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shlobj_core.h (includere Shlobj.h, Shlobj_core.h) |
Libreria | Shell32.lib |
DLL | Shell32.dll (versione 6.0 o successiva) |
Set di API | ext-ms-win-shell-shell32-l1-2-1 (introdotta in Windows 10, versione 10.0.10240) |