SHSetLocalizedName 函式 (shellapi.h)

設定 Shell 資料夾中檔案的當地語系化名稱。

語法

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

參數

[in] pszPath

類型： PCWSTR

指定目標檔案完整路徑之字串的指標。

[in] pszResModule

類型： PCWSTR

字串資源的指標，指定檔案名的當地語系化版本。

idsRes

類型： int

指定字串資源中當地語系化檔案名的整數識別碼。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

設定此字串時，Explorer 會顯示此字串，而不是檔案名。 檔案的路徑未變更。

應用程式可以使用IShellFolder：：GetDisplayNameOf搭配SIGDN_NORMALDISPLAY旗標取得 (當地語系化) 名稱，以及使用SIGDN_DESKTOPABSOLUTEPARSING 旗標以IShellItem：：GetDisplayName剖析 (非當地語系化) 名稱。

呼叫 SHRemoveLocalizedName 會使顯示名稱與剖析名稱相同。

需求

最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shellapi.h
Dll	Shell32.dll;Shell32.dll (5.6 版或更新版本)
API 集合	ext-ms-win-shell-shell32-l1-2-0 (在 Windows 8.1) 中引進