Fonction SHUpdateImageA (shlobj_core.h)

Article
03/02/2024

Avertit l’interpréteur de commandes qu’une image de la liste d’images système a changé.

Syntaxe

void SHUpdateImageA(
  [in] LPCSTR pszHashItem,
  [in] int    iIndex,
  [in] UINT   uFlags,
  [in] int    iImageIndex
);

Paramètres

[in] pszHashItem

Type : LPCTSTR

Pointeur vers une valeur de chaîne qui spécifie le chemin d’accès complet du fichier qui contient l’icône. Utilisez le chemin retourné dans la mémoire tampon vers laquelle pointe le paramètre szIconFile de IExtractIcon ::GetIconLocation.

[in] iIndex

Type : int

Entier qui spécifie l’index de base zéro de l’icône dans le fichier spécifié par pszHashItem. Utilisez la valeur vers laquelle pointe le paramètre piIndex de IExtractIcon ::GetIconLocation.

[in] uFlags

Type : UINT

Entier non signé qui spécifie les indicateurs qui déterminent les attributs d’icône. Définissez uFlags sur la valeur vers laquelle pointe le paramètre pwFlags de IExtractIcon ::GetIconLocation. Les indicateurs pertinents pour SHUpdateImage sont GIL_NOTFILENAME et GIL_SIMULATEDOC.

[in] iImageIndex

Type : int

Entier qui spécifie l’index dans la liste d’images système de l’icône en cours de mise à jour.

Valeur de retour

None

Remarques

Si vous ne connaissez pas l’index dans la liste d’images système de l’icône que vous souhaitez mettre à jour, utilisez SHGetFileInfo avec le paramètre uFlags défini sur SHGFI_SYSICONINDEX.

Vous devez utiliser IExtractIcon ::GetIconLocation avec les paramètres de l’ancienne icône qui doit être mise à jour, et non ceux de la nouvelle icône par laquelle vous souhaitez la remplacer.

Notes

L’en-tête shlobj_core.h définit SHUpdateImage en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h, Shlobj_core.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 4.7 ou ultérieure)

Voir aussi

SHChangeNotify

Partager via