SHSetLocalizedName 函数 (shellapi.h)

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

Syntax

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

参数

[in] pszPath

类型:PCWSTR

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

[in] pszResModule

类型:PCWSTR

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

idsRes

类型:int

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

返回值

类型:HRESULT

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

注解

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

应用程序可以使用 iShellFolder::GetDisplayNameOfSIGDN_NORMALDISPLAY 标志以及使用 SIGDN_DESKTOPABSOLUTEPARSING 标志通过 IShellItem::GetDisplayName 解析(非本地化)名称来获取显示(本地化)名称。

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

要求

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