Funzione ExtractIconA (shellapi.h)

Articolo
03/01/2024

Ottiene un handle a un'icona dal file eseguibile, dalla DLL o dal file icona specificato.

Per recuperare una matrice di handle in icone di grandi o piccole dimensioni, usare la funzione ExtractIconEx .

Sintassi

HICON ExtractIconA(
  [in] HINSTANCE hInst,
  [in] LPCSTR    pszExeFileName,
       UINT      nIconIndex
);

Parametri

[in] hInst

Tipo: HINSTANCE

Gestire l'istanza dell'applicazione che chiama la funzione.

[in] pszExeFileName

Tipo: LPCTSTR

Puntatore a una stringa con terminazione null che specifica il nome di un file eseguibile, una DLL o un file icona.

nIconIndex

Tipo: UINT

Specifica l'indice in base zero dell'icona da recuperare. Ad esempio, se questo valore è 0, la funzione restituisce un handle alla prima icona nel file specificato.

Se questo valore è -1, la funzione restituisce il numero totale di icone nel file specificato. Se il file è un file eseguibile o una DLL, il valore restituito è il numero di risorse RT_GROUP_ICON. Se il file è un oggetto . File ICO, il valore restituito è 1.

Se questo valore è un numero negativo non uguale a –1, la funzione restituisce un handle all'icona nel file specificato il cui identificatore di risorsa è uguale al valore assoluto di nIconIndex. Ad esempio, è consigliabile usare –3 per estrarre l'icona il cui identificatore di risorsa è 3. Per estrarre l'icona il cui identificatore di risorsa è 1, usare la funzione ExtractIconEx .

Valore restituito

Tipo: HICON

Il valore restituito è un handle per un'icona. Se il file specificato non era un file eseguibile, una DLL o un file icona, la restituzione è 1. Se non sono state trovate icone nel file, il valore restituito è NULL.

Commenti

Quando non è più necessario, è necessario eliminare l'handle dell'icona restituito da ExtractIcon chiamando la funzione DestroyIcon .

Nota

L'intestazione shellapi.h definisce ExtractIcon 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

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

Vedi anche

ExtractAssociatedIcon

ExtractAssociatedIconEx

ExtractIconEx

Condividi tramite