Metode IShellItemArray::BindToHandler (shobjidl_core.h)

Artikel
03/02/2024

Mengikat ke objek dengan cara handler yang ditentukan.

Sintaks

HRESULT BindToHandler(
  [in]  IBindCtx *pbc,
  [in]  REFGUID  bhid,
  [in]  REFIID   riid,
  [out] void     **ppvOut
);

Parameter

[in] pbc

Jenis: IBindCtx*

Penunjuk ke antarmuka IBindCtx pada objek konteks ikatan.

[in] bhid

Jenis: REFGUID

Salah satu nilai berikut, didefinisikan dalam Shlguid.h, yang menentukan handler.

BHID_SFUIObject

Membatasi penggunaan ke GetUIObjectOf. Gunakan jenis handler ini hanya untuk array item datar, di mana semua item berada dalam folder yang sama.

BHID_DataObject

Diperkenalkan di Windows Vista: Mendapatkan objek IDataObject untuk digunakan dengan item atau array item. Gunakan jenis handler ini hanya untuk objek datar atau array item yang dibuat oleh SHCreateShellItemArrayFromDataObject.

BHID_AssociationArray

Diperkenalkan di Windows Vista: Mendapatkan objek IQueryAssociations untuk digunakan dengan item atau array item. Ini hanya mengambil objek array asosiasi untuk item pertama di IShellItemArray

[in] riid

Jenis: REFIID

IID dari jenis objek yang akan diambil.

[out] ppvOut

Jenis: batal**

Ketika metode ini kembali, berisi objek yang ditentukan dalam riid yang dikembalikan oleh handler yang ditentukan oleh rbhid.

Mengembalikan nilai

Jenis: HRESULT

Jika metode ini berhasil, metode 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	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui