Función SHSetLocalizedName (shellapi.h)

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

Sintaxis

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

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

Tipo: HRESULT

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

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 presentació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 .

La llamada a SHRemoveLocalizedName hace que el nombre para mostrar sea idéntico al nombre de análisis.


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shellapi.h
Archivo DLL	Shell32.dll; Shell32.dll (versión 5.6 o posterior)
Conjunto de API	ext-ms-win-shell-shell32-l1-2-0 (introducido en Windows 8.1)