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) |