Metodo IAssocHandler::GetIconLocation (shobjidl_core.h)

Articolo
03/02/2024

Recupera la posizione dell'icona associata all'applicazione.

Sintassi

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

Parametri

[out] ppszPath

Tipo: LPWSTR*

Quando termina, questo metodo contiene l'indirizzo di un puntatore a una stringa Unicode con terminazione Null contenente il percorso dell'icona dell'applicazione.

[out] pIndex

Tipo: int*

Quando termina, questo metodo contiene un puntatore all'indice dell'icona all'interno della risorsa denominata in ppszPath.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se non è possibile trovare l'icona, la funzione restituirà il percorso dell'eseguibile e un indice icona pari a zero.

Per motivi di prestazioni, un'applicazione può usare la cache delle immagini della shell per recuperare l'icona, anziché caricare l'icona direttamente dal percorso restituito. L'indice del percorso e dell'icona può essere passato direttamente a Shell_GetCachedImageIndex. Un vantaggio di questo è che la cache della shell può fornire un'icona predefinita nel caso in cui non fosse disponibile alcuna icona per l'applicazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite