Funzione ExtractAssociatedIconA (shellapi.h)

Ottiene un handle per un'icona archiviata come risorsa in un file o in un'icona archiviata nel file eseguibile associato di un file.

Sintassi

HICON ExtractAssociatedIconA(
  [in]      HINSTANCE hInst,
  [in, out] LPSTR     pszIconPath,
  [in, out] WORD      *piIcon
);

Parametri

[in] hInst

Tipo: HINSTANCE

Handle per l'istanza dell'applicazione chiamante.

[in, out] pszIconPath

Tipo: LPTSTR

Puntatore a una stringa che, nella voce, specifica il percorso completo e il nome file del file che contiene l'icona. La funzione estrae l'handle dell'icona da tale file o da un file eseguibile associato a tale file.

Quando questa funzione viene restituita, se l'handle dell'icona è stato ottenuto da un file eseguibile ,ovvero un file eseguibile a cui punta lpIconPath o un file eseguibile associato, la funzione archivia il percorso completo e il nome file del file eseguibile nel buffer a cui punta questo parametro.

[in, out] piIcon

Tipo: LPWORD

Puntatore a un valore di WORD che, nella voce, specifica l'indice dell'icona il cui handle deve essere ottenuto.

Quando la funzione viene restituita, se l'handle dell'icona è stato ottenuto da un file eseguibile (un file eseguibile a cui punta lpIconPath o un file eseguibile associato), questo valore punta all'indice dell'icona in tale file.

Valore restituito

Tipo: HICON

Se la funzione ha esito positivo, il valore restituito è un handle di icona. Se l'icona viene estratta da un file eseguibile associato, la funzione archivia il percorso completo e il nome file del file eseguibile nella stringa a cui punta lpIconPath e archivia l'identificatore dell'icona in WORD a cui punta lpiIcon.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Quando non è più necessario, il chiamante è responsabile della liberazione dell'handle dell'icona restituito da ExtractAssociatedIcon chiamando la funzione DestroyIcon .

La funzione ExtractAssociatedIcon cerca innanzitutto l'icona indicizzata nel file specificato da lpIconPath. Se la funzione non riesce a ottenere l'handle dell'icona da tale file e il file ha un file eseguibile associato, cerca tale file eseguibile per un'icona. Le associazioni con i file eseguibili si basano sulle estensioni di file e vengono archiviate nella parte per utente del Registro di sistema.

Nota

L'intestazione shellapi.h definisce ExtractAssociatedIcon come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

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 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

ExtractAssociatedIconEx

ExtractIcon

ExtractIconEx