Funzione ExtractAssociatedIconW (shellapi.h)

Articolo
08/26/2023

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 ExtractAssociatedIconW(
  [in]      HINSTANCE hInst,
  [in, out] LPWSTR    pszIconPath,
  [in, out] WORD      *piIcon
);

Parametri

[in] hInst

Tipo: HINSTANCE

Handle all'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 restituisce, se l'handle dell'icona è stato ottenuto da un file eseguibile (un file eseguibile a cui fa riferimento lpIconPath o un file eseguibile associato) la funzione archivia il percorso completo e il nome file di tale 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 restituisce, se l'handle dell'icona è stato ottenuto da un file eseguibile (un file eseguibile a cui fa riferimento 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 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 prima di tutto 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, sembra nel file eseguibile per un'icona. Le associazioni con file eseguibili si basano sulle estensioni del nome 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 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

ExtractAssociatedIconEx

ExtractIcon

ExtractIconEx