Fungsi SHBindToFolderIDListParentEx (shlobj_core.h)

Artikel
03/02/2024

Memperluas fungsi SHBindToFolderIDListParent dengan memungkinkan pemanggil menentukan konteks ikatan.

Sintaks

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

Parameter

[in, optional] psfRoot

Jenis: IShellFolder*

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

[in] pidl

Jenis: PCUIDLIST_RELATIVE

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

[in, optional] ppbc

Jenis: IBindCtx*

Penunjuk ke antarmuka IBindCtx pada objek konteks ikatan yang akan digunakan selama operasi ini. Jika parameter ini tidak digunakan, atur ke NULL, yang setara dengan memanggil fungsi SHBindToFolderIDListParent . Karena dukungan untuk pbc bersifat opsional untuk implementasi objek folder, beberapa folder mungkin tidak mendukung penggunaan konteks ikatan.

[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: void**

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.

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

SHBindToFolderIDListParent

Bagikan melalui