Bagikan melalui

Fungsi SHBindToParent (shlobj_core.h)

  • Artikel

Membawa penunjuk ke daftar pengidentifikasi item yang sepenuhnya memenuhi syarat (PIDL), dan mengembalikan penunjuk antarmuka tertentu pada objek induk.

Sintaks

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

Parameter

[in] pidl

Jenis: PCIDLIST_ABSOLUTE

PIDL item.

[in] riid

Jenis: REFIID

REFIID dari salah satu antarmuka yang diekspos oleh objek induk item.

[out] ppv

Jenis: VOID**

Pointer ke antarmuka yang ditentukan oleh riid. Anda harus melepaskan objek setelah selesai.

[out] ppidlLast

Jenis: PCUITEMID_CHILD*

PIDL item relatif terhadap folder induk. PIDL ini dapat digunakan dengan banyak metode yang didukung oleh antarmuka folder induk. Jika Anda mengatur ppidlLast ke NULL, PIDL tidak dikembalikan.

CatatanSHBindToParent tidak mengalokasikan PIDL baru; itu hanya menerima pointer melalui parameter ini. Oleh karena itu, Anda tidak bertanggung jawab untuk membebaskan sumber daya ini.
 

Mengembalikan nilai

Jenis: HRESULT

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, 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 5.0 atau yang lebih baru)