Fungsi SHParseDisplayName (shlobj_core.h)

Artikel
03/13/2024

Menerjemahkan nama tampilan objek namespace Shell ke dalam daftar pengidentifikasi item dan mengembalikan atribut objek. Fungsi ini adalah metode yang lebih disukai untuk mengonversi string menjadi penunjuk ke daftar pengidentifikasi item (PIDL).

Sintaks

SHSTDAPI SHParseDisplayName(
  [in]            PCWSTR           pszName,
  [in, optional]  IBindCtx         *pbc,
  [out]           PIDLIST_ABSOLUTE *ppidl,
  [in]            SFGAOF           sfgaoIn,
  [out, optional] SFGAOF           *psfgaoOut
);

Parameter

[in] pszName

Jenis: LPCWSTR

Penunjuk ke string lebar yang dihentikan nol yang berisi nama tampilan untuk diurai.

[in, optional] pbc

Jenis: IBindCtx*

Konteks ikatan yang mengontrol operasi penguraian. Parameter ini biasanya diatur ke NULL.

[out] ppidl

Jenis: PIDLIST_ABSOLUTE*

Alamat penunjuk ke variabel jenis ITEMIDLIST yang menerima daftar pengidentifikasi item untuk objek. Jika terjadi kesalahan, maka parameter ini diatur ke NULL.

[in] sfgaoIn

Jenis: SFGAOF

Nilai ULONG yang menentukan atribut yang akan dikueri. Untuk mengkueri satu atau beberapa atribut, inisialisasi parameter ini dengan bendera yang mewakili atribut yang diminati. Untuk daftar bendera SFGAO yang tersedia, lihat SFGAO.

[out, optional] psfgaoOut

Jenis: SFGAOF*

Penunjuk ke ULONG. Saat dikembalikan, atribut yang benar untuk objek dan diminta dalam sfgaoIn diatur. Bendera atribut objek bisa nol atau kombinasi bendera SFGAO. Untuk daftar bendera SFGAO yang tersedia, lihat SFGAO.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Anda harus memanggil fungsi ini dari utas latar belakang. Kegagalan untuk melakukannya dapat menyebabkan UI berhenti merespons.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.0 atau yang lebih baru)

Lihat juga

IBindCtx

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

DAFTAR ITEMID

SHGetPathFromIDList

Bagikan melalui