Fungsi SHGetNameFromIDList (shobjidl_core.h)

Artikel
03/02/2024

Mengambil nama tampilan item yang diidentifikasi oleh IDList-nya.

Sintaks

SHSTDAPI SHGetNameFromIDList(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  SIGDN             sigdnName,
  [out] PWSTR             *ppszName
);

Parameter

[in] pidl

Jenis: PCIDLIST_ABSOLUTE

PIDL yang mengidentifikasi item.

[in] sigdnName

Jenis: SIGDN

Nilai dari enumerasi SIGDN yang menentukan jenis nama tampilan yang akan diambil.

[out] ppszName

Jenis: PWSTR*

Nilai yang, ketika fungsi ini berhasil dikembalikan, menerima alamat penunjuk ke nama tampilan yang diambil.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Pemanggil bertanggung jawab untuk membebaskan string yang ditujukan oleh ppszName ketika tidak lagi diperlukan. Panggil CoTaskMemFree pada *ppszName untuk membebaskan memori.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll

Bagikan melalui