設定 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 旗標使用 IShellItem::GetDisplayName 來剖析 (非當地語系化) 名稱。
呼叫 SHRemoveLocalizedName 會讓顯示名稱與剖析名稱相同。
需求
| Requirement | 價值觀 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 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 中引進) |