Share via

Funzione ExtractAssociatedIconExA (shellapi.h)

  • Articolo

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

Vedi anche

ExtractAssociatedIcon

ExtractIcon

ExtractIconEx