ExtractAssociatedIcon

La funzione ExtractAssociatedIcon restituisce un handle per un'icona indicizzata trovate un file o un'icona trovati in un file eseguibile associato.

(HICON ExtractAssociatedIcon HINSTANCE  hInst, / / handle di istanza di applicazioneLPTSTRlpIconPath, / / percorso e il nome del file per il quale icona  / / wantedLPWORDlpiIcon / / puntatore all'indice icona);
 

Parametri

hInst
Specifica l'istanza dell'applicazione chiamata della funzione.
lpIconPath
Puntatore a una stringa che specifica il percorso completo e il nome del file per il quale un'icona desiderata. La funzione estrae l'handle icona da quel file o da un file eseguibile associato a quel file.

Se l'handle di icona ottenuto da un file eseguibile, la funzione memorizza il percorso completo e il nome dell'eseguibile che nella stringa a cui puntata lpIconPath.

lpiIcon
Puntatore a una parola che specifica l'indice dell'icona cui manico di ottenere.

Se l'handle di icona ottenuto da un file eseguibile, la funzione memorizza identificatore dell'icona nella parola indicata da lpiIcon.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito un handle di icona. Se l'icona estratta da un file eseguibile associato, la funzione memorizza il percorso completo e il nome del file eseguibile nella stringa a cui puntata lpIconPathe memorizza identificatore dell'icona nella parola indicata da lpiIcon.

Se la funzione ha esito negativo, il valore restituito NULL.

Osservazioni

La funzione ExtractAssociatedIcon cerca innanzitutto l'icona indicizzata nel file specificato da lpIconPath. Se la funzione non possibile ottenere l'handle icona da quel file e il file un file eseguibile associato, sembra in quel file eseguibile per un'icona. Associazioni con file eseguibili sono basate su estensioni del nome file, vengono memorizzate nella parte di ogni utente del Registro di sistema e possono essere definite utilizzando il comando associato del File Manager.

Descrizione

nbsp;Windows &NT: richiede una versione 3.5 o successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Non supportato.
Intestazione:Dichiarati in Shellapi.
Importare librerie:Utilizzare shell32.lib.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di icone, icona funzioni, ExtractIcon

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index