Función SHSetLocalizedName (shellapi.h)

Establece el nombre localizado de un archivo en una carpeta de Shell.

Syntax

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

Parámetros

[in] pszPath

Tipo: PCWSTR

Puntero a una cadena que especifica la ruta de acceso completa del archivo de destino.

[in] pszResModule

Tipo: PCWSTR

Puntero a un recurso de cadena que especifica la versión localizada del nombre de archivo.

idsRes

Tipo: int

Identificador entero que especifica el nombre de archivo localizado en el recurso de cadena.

Valor devuelto

Tipo: HRESULT

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error HRESULT .

Observaciones

Cuando se establece esta cadena, el Explorador muestra esta cadena en lugar del nombre de archivo. La ruta de acceso al archivo no cambia.

Las aplicaciones pueden obtener el nombre de visualización (localizado) con IShellFolder::GetDisplayNameOf con la marca SIGDN_NORMALDISPLAY y el nombre de análisis (no localizado) con IShellItem::GetDisplayName mediante la marca SIGDN_DESKTOPABSOLUTEPARSING .

Al llamar a SHRemoveLocalizedName , el nombre para mostrar es idéntico al nombre de análisis.

Requisitos