SHSetLocalizedName, fonction (shellapi.h)

Définit le nom localisé d’un fichier dans un dossier Shell.

Syntaxe

SHSTDAPI SHSetLocalizedName(
  [in] PCWSTR pszPath,
  [in] PCWSTR pszResModule,
       int    idsRes
);

[in] pszPath

Type : PCWSTR

Pointeur vers une chaîne qui spécifie le chemin complet du fichier cible.

[in] pszResModule

Type : PCWSTR

Pointeur vers une ressource de chaîne qui spécifie la version localisée du nom de fichier.

idsRes

Type : int

ID entier qui spécifie le nom de fichier localisé dans la ressource de chaîne.

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Lorsque cette chaîne est définie, Explorer affiche cette chaîne au lieu du nom de fichier. Le chemin d’accès au fichier est inchangé.

Les applications peuvent obtenir le nom d’affichage (localisé) avec IShellFolder::GetDisplayNameOf avec l’indicateur SIGDN_NORMALDISPLAY et le nom d’analyse (non localisé) avec IShellItem::GetDisplayName à l’aide de l’indicateur SIGDN_DESKTOPABSOLUTEPARSING .

L’appel de SHRemoveLocalizedName rend le nom d’affichage identique au nom d’analyse.


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shellapi.h
DLL	Shell32.dll; Shell32.dll (version 5.6 ou ultérieure)
Ensemble d’API	ext-ms-win-shell-shell32-l1-2-0 (introduit dans Windows 8.1)