SHSetLocalizedName 函数 (shellapi.h)

  • 项目

设置 Shell 文件夹中文件的本地化名称。

语法

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

参数

[in] pszPath

类型： PCWSTR

指向指定目标文件的完全限定路径的字符串的指针。

[in] pszResModule

类型： PCWSTR

指向字符串资源的指针，该资源指定文件名的本地化版本。

idsRes

类型： int

一个整数 ID，指定字符串资源中的本地化文件名。

返回值

类型： HRESULT

如果此函数成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

设置此字符串后，资源管理器将显示此字符串，而不是文件名。 文件的路径保持不变。

应用程序可以使用 IShellFolder：：GetDisplayNameOf 获取显示 (本地化) 名称，使用 SIGDN_NORMALDISPLAY 标志和使用 SIGDN_DESKTOPABSOLUTEPARSING 标志分析 (非本地化) 名称。

调用 SHRemoveLocalizedName 会使显示名称与分析名称相同。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shellapi.h
DLL Shell32.dll;Shell32.dll (版本 5.6 或更高版本)
API 集 在 Windows 8.1) 中引入的 ext-ms-win-shell-shell32-l1-2-0 (