Bagikan melalui


Fungsi SHSetLocalizedName (shellapi.h)

Mengatur nama file yang dilokalkan dalam folder Shell.

Sintaks

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

Parameter

[in] pszPath

Jenis: PCWSTR

Penunjuk ke string yang menentukan jalur file target yang sepenuhnya memenuhi syarat.

[in] pszResModule

Jenis: PCWSTR

Penunjuk ke sumber daya string yang menentukan versi nama file yang dilokalkan.

idsRes

Jenis: int

ID bilangan bulat yang menentukan nama file yang dilokalkan dalam sumber daya string.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Ketika string ini diatur, Explorer menampilkan string ini alih-alih nama file. Jalur ke file tidak berubah.

Aplikasi bisa mendapatkan nama tampilan (dilokalkan) dengan IShellFolder::GetDisplayNameOf dengan bendera SIGDN_NORMALDISPLAY dan nama penguraian (non-lokal) dengan IShellItem::GetDisplayName menggunakan bendera SIGDN_DESKTOPABSOLUTEPARSING .

Memanggil SHRemoveLocalizedName membuat nama tampilan identik dengan nama penguraian.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shellapi.h
DLL Shell32.dll; Shell32.dll (versi 5.6 atau yang lebih baru)
Set API ext-ms-win-shell-shell32-l1-2-0 (diperkenalkan di Windows 8.1)