FONCTION SHUpdateImageA (shlobj_core.h)

Article
11/20/2024

Avertit l’interpréteur de commandes qu’une image dans 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 d’accès retourné dans la mémoire tampon pointée par 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 pointée par 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 indiquée par 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

Aucun

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 celles de la nouvelle icône que vous souhaitez remplacer par.

Note

L’en-tête shlobj_core.h définit SHUpdateImage comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlobj_core.h (include Shlobj.h, Shlobj_core.h)
bibliothèque	Shell32.lib
DLL	Shell32.dll (version 4.7 ou ultérieure)

Voir aussi

SHChangeNotify

Partager via