IAssocHandler ::GetIconLocation, méthode (shobjidl_core.h)

Récupère l’emplacement de l’icône associée à l’application.

Syntaxe

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

Paramètres

[out] ppszPath

Type : LPWSTR*

Lorsque cette méthode est retournée, contient l’adresse d’un pointeur vers une chaîne Unicode terminée par null qui contient le chemin d’accès à l’icône de l’application.

[out] pIndex

Type : int*

Lorsque cette méthode est retournée, contient un pointeur vers l’index de l’icône dans la ressource nommée dans ppszPath.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si l’icône est introuvable, la fonction retourne le chemin d’accès à l’exécutable et un index d’icône de zéro.

Pour des raisons de performances, une application peut utiliser le cache d’images shell pour récupérer l’icône, au lieu de charger l’icône directement à partir du chemin d’accès retourné. Le chemin d’accès et l’index d’icône peuvent être transmis directement à Shell_GetCachedImageIndex. L’un des avantages est que le cache de l’interpréteur de commandes peut fournir une icône par défaut dans le cas où aucune icône n’était disponible pour l’application.

Configuration requise