Fungsi SHBindToFolderIDListParent (shlobj_core.h)

Artikel
03/02/2024

Mengingat item namespace Shell yang ditentukan dalam bentuk folder, dan daftar pengidentifikasi item relatif terhadap folder tersebut, fungsi ini mengikat ke induk item namespace dan secara opsional mengembalikan penunjuk ke komponen akhir daftar pengidentifikasi item.

Sintaks

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

Parameter

[in, optional] psfRoot

Jenis: IShellFolder*

Penunjuk ke objek folder Shell. Jika psfRootADALAH NULL, menunjukkan bahwa IDList yang diteruskan relatif terhadap desktop.

[in] pidl

Jenis: PCUIDLIST_RELATIVE

PIDL untuk mengikat, relatif terhadap psfRoot. Jika psfRootNULL, ini adalah IDList absolut relatif terhadap folder desktop.

[in] riid

Jenis: REFIID

Referensi ke ID antarmuka yang diinginkan. Ini biasanya IID_IShellFolder atau IID_IShellFolder2, tetapi bisa menjadi apa pun yang didukung oleh folder target.

[out] ppv

Jenis: batal**

Ketika fungsi ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IShellFolder atau IShellFolder2, tetapi bisa menjadi apa pun yang didukung oleh folder target.

[out, optional] ppidlLast

Jenis: PCUITEMID_CHILD*

Penunjuk ke ID terakhir parameter pidl , dan merupakan ID anak yang relatif terhadap folder induk yang dikembalikan dalam ppv. Nilai ini bisa NULL.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Catatan Memanggil fungsi SHBindToFolderIDListParent setara dengan memanggil fungsi SHBindToFolderIDListParentEx dengan NULL sebagai konteks ikat.

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	shlobj_core.h (termasuk Shlobj.h)
DLL	Shell32.dll

Lihat juga

SHBindToFolderIDListParentEx

Bagikan melalui