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) |