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

Article
03/02/2024

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

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Partager via