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
);

Paramètres

[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.

Valeur retournée

Type : HRESULT

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

Remarques

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.

Configuration requise