Fungsi SHSetLocalizedName (shellapi.h)

Mengatur nama file yang dilokalkan dalam folder Shell.

Syntax

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

Parameter-parameternya

[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.

Mengembalikan nilai

Jenis: HRESULT

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

Komentar

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	shellapi.h
Library	OneCore.Lib
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)