Funzione ExtractAssociatedIconA (shellapi.h)

Articolo
11/20/2024

Ottiene un handle per un'icona archiviata come risorsa in un file o 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 termina, se l'handle dell'icona è stato ottenuto da un file eseguibile (un file eseguibile a cui punta lpIconPath o un file eseguibile associato), la funzione archivia il percorso completo e il nome del file eseguibile nel buffer a cui punta questo parametro.

[in, out] piIcon

Tipo: LPWORD

Puntatore a un valore 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 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 lpIconPathe archivia l'identificatore dell'icona nell'WORD a cui punta lpiIcon.

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

Osservazioni

Quando non è più necessario, il chiamante è responsabile della liberazione dell'handle 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
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)

Vedere anche

ExtractAssociatedIconEx

ExtractIcon

ExtractIconEx

Condividi tramite