Fonction SHUpdateImageA (shlobj_core.h)
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) |