IShellItem：：BindToHandler 方法 (shobjidl_core.h)

發行項
03/05/2024

系結至處理程式標識碼值所指定專案的處理程式， (BHID) 。

語法

HRESULT BindToHandler(
  IBindCtx *pbc,
  REFGUID  bhid,
  REFIID   riid,
  void     **ppv
);

參數

pbc

類型： IBindCtx*

系結內容物件上 IBindCtx 介面的指標。用來將選擇性參數傳遞至處理程式。系結內容的內容是處理程式特定的。例如，系結至 BHID_Stream時，系結內容中的 STGM 旗標會指出所需的存取模式， (讀取或讀取/寫入) 。

bhid

類型： REFGUID

GUID 的參考，指定要建立哪一個處理程式。 Shlguid.h 中定義的下列其中一個值：

BHID_SFObject

限制使用 BindToObject。

BHID_SFUIObject

限制使用 GetUIObjectOf。

BHID_SFViewObject

限制使用 CreateViewObject。

BHID_Storage

嘗試擷取記憶體 RIID，但預設為失敗時的殼層實作。

BHID_Stream

將使用量限制為 IStream。

BHID_LinkTargetItem

CLSID_ShellItem是以這個專案的目標初始化， (只能SFGAO_LINK) 。如需SFGAO_LINK的描述，請參閱 SFGAO 。

BHID_StorageEnum

如果專案是資料夾，會取得要列舉記憶體內容的 IEnumShellItems 物件。

BHID_Transfer

在 Windows Vista 中引進：如果項目是資料夾，會取得 ITransferSource 或 ITransferDestination 物件。

BHID_PropertyStore

Windows Vista 中引進：限制 IPropertyStore 或 IPropertyStoreFactory 的使用方式。

BHID_ThumbnailHandler

Windows Vista 中引進：限制 IExtractImage 或 IThumbnailProvider 的使用方式。

BHID_EnumItems

在 Windows Vista 中引進：如果專案是資料夾，會取得 IEnumShellItems 物件，該物件會列舉資料夾中的所有專案。這包括資料夾、非資料夾和隱藏專案。

BHID_DataObject

在 Windows Vista 中引進：取得 IDataObject 物件，以便與專案或項目陣列搭配使用。

BHID_AssociationArray

在 Windows Vista 中引進：取得 IQueryAssociations 物件，以便與專案或項目數位搭配使用。

BHID_Filter

Windows Vista 中引進：限制 IFilter 的使用方式。

BHID_EnumAssocHandlers

在 Windows 7 中引進：取得 IEnumAssocHandlers 物件，用來列舉指定專案的建議關聯處理程式。

BHID_RandomAccessStream

Windows 8 中引進：取得專案的 IRandomAccessStream 物件。

BHID_FilePlaceholder

Windows 8.1 中引進：取得用來提供佔位符檔案功能的物件。

riid

類型： REFIID

要擷取之物件類型的 IID。

ppv

類型： void**

當這個方法傳回時，會包含 rbhid 所指定處理程式所傳回之 riid 類型的指標。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows XP with SP1 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)
Dll	Shell32.dll (5.00 版或更新版本)

另請參閱

IShellFolder

IShellItem

共用方式為