Funzione ExtractAssociatedIconExA (shellapi.h)
[ExtractAssociatedIconEx è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Può essere modificato o non disponibile nelle versioni successive.
Ottiene un handle per un'icona archiviata come risorsa in un file o un'icona archiviata nel file eseguibile associato di un file. Estende la funzione ExtractAssociatedIcon recuperando l'ID dell'icona quando tale icona viene estratta da un file eseguibile.
Sintassi
HICON ExtractAssociatedIconExA(
[in] HINSTANCE hInst,
[in, out] LPSTR pszIconPath,
[in, out] WORD *piIconIndex,
[in, out] WORD *piIconId
);
Parametri
[in] hInst
Tipo: HINSTANCE
Handle del modulo da cui estrarre l'icona.
[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 direttamente puntato da questo parametro o da 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] piIconIndex
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.
[in, out] piIconId
Tipo: LPWORD
Puntatore a un valore WORD che, nella voce, specifica l'ID 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'ID dell'icona all'interno di tale file.
Valore restituito
Tipo: HICON
Restituisce l'handle dell'icona se ha esito positivo, in caso contrario NULL.
Commenti
L'handle dell'icona restituito da questa funzione deve essere rilasciato chiamando DestroyIcon quando non è più necessario.
Nota
L'intestazione shellapi.h definisce ExtractAssociatedIconEx 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 Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | shellapi.h |
Libreria | Shell32.lib |
DLL | Shell32.dll (versione 5.0 o successiva) |