Fonction SHUpdateImageW (shlobj_core.h)

Article
08/26/2023

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

Syntaxe

void SHUpdateImageW(
  [in] LPCWSTR 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 complet du fichier qui contient l’icône. Utilisez le chemin d’accès retourné dans la mémoire tampon pointée vers 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 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 à 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 à mettre à 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 comme un 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.

Configuration requise


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