Funzione ExtractAssociatedIconExA (shellapi.h)

Articolo
11/20/2024

[ExtractAssociatedIconEx è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe 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 viene restituita, se l'handle dell'icona è stato ottenuto da un file eseguibile (un file eseguibile a cui punta direttamente questo parametro 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] 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 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.

[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 termina, 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'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.

Osservazioni

L'handle 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 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 Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shellapi.h
libreria	Shell32.lib
dll	Shell32.dll (versione 5.0 o successiva)

Vedere anche

extractAssociatedIcon

ExtractIcon

ExtractIconEx

Condividi tramite