Metode IShellItem::BindToHandler (shobjidl_core.h)
Mengikat ke handler untuk item seperti yang ditentukan oleh nilai ID handler (BHID).
Sintaks
HRESULT BindToHandler(
IBindCtx *pbc,
REFGUID bhid,
REFIID riid,
void **ppv
);
Parameter
pbc
Jenis: IBindCtx*
Penunjuk ke antarmuka IBindCtx pada objek konteks ikatan. Digunakan untuk meneruskan parameter opsional ke handler. Konten konteks ikatan bersifat khusus handler. Misalnya, saat mengikat ke BHID_Stream, bendera STGM dalam konteks ikat menunjukkan mode akses yang diinginkan (baca atau baca/tulis).
bhid
Jenis: REFGUID
Referensi ke GUID yang menentukan handler mana yang akan dibuat. Salah satu nilai berikut yang ditentukan dalam Shlguid.h:
BHID_SFObject
Membatasi penggunaan ke BindToObject.
BHID_SFUIObject
Membatasi penggunaan ke GetUIObjectOf.
BHID_SFViewObject
Membatasi penggunaan ke CreateViewObject.
BHID_Storage
Mencoba untuk mengambil RIID penyimpanan, tetapi default ke implementasi Shell pada kegagalan.
BHID_Stream
Membatasi penggunaan ke IStream.
BHID_LinkTargetItem
CLSID_ShellItem diinisialisasi dengan target item ini (hanya dapat SFGAO_LINK). Lihat SFGAO untuk deskripsi SFGAO_LINK.
BHID_StorageEnum
Jika item adalah folder, mendapatkan objek IEnumShellItems untuk menghitung konten penyimpanan.
BHID_Transfer
Diperkenalkan di Windows Vista: Jika item adalah folder, mendapatkan objek ITransferSource atau ITransferDestination .
BHID_PropertyStore
Diperkenalkan di Windows Vista: Membatasi penggunaan ke IPropertyStore atau IPropertyStoreFactory.
BHID_ThumbnailHandler
Diperkenalkan di Windows Vista: Membatasi penggunaan ke IExtractImage atau IThumbnailProvider.
BHID_EnumItems
Diperkenalkan di Windows Vista: Jika item adalah folder, mendapatkan objek IEnumShellItems yang menghitung semua item dalam folder. Ini termasuk folder, nonfolder, dan item tersembunyi.
BHID_DataObject
Diperkenalkan di Windows Vista: Mendapatkan objek IDataObject untuk digunakan dengan item atau array item.
BHID_AssociationArray
Diperkenalkan di Windows Vista: Mendapatkan objek IQueryAssociations untuk digunakan dengan item atau array item.
BHID_Filter
Diperkenalkan di Windows Vista: Membatasi penggunaan ke IFilter.
BHID_EnumAssocHandlers
Diperkenalkan di Windows 7: Mendapatkan objek IEnumAssocHandlers yang digunakan untuk menghitung handler asosiasi yang direkomendasikan untuk item yang diberikan.
BHID_RandomAccessStream
Diperkenalkan dalam Windows 8: Mendapatkan objek IRandomAccessStream untuk item.
BHID_FilePlaceholder
Diperkenalkan di Windows 8.1: Mendapatkan objek yang digunakan untuk menyediakan fungsionalitas file tempat penampung.
riid
Jenis: REFIID
IID dari jenis objek yang akan diambil.
ppv
Jenis: batal**
Ketika metode ini kembali, berisi pointer jenis riid yang dikembalikan oleh handler yang ditentukan oleh rbhid.
Nilai kembali
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 XP dengan SP1 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | shobjidl_core.h (termasuk Shobjidl.h) |
| DLL | Shell32.dll (versi 5.00 atau yang lebih baru) |