设置 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::GetDisplayNameOf 和 SIGDN_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 中引入) |