IShellItem::BindToHandler メソッド (shobjidl_core.h)

[アーティクル]
06/21/2023

ハンドラー ID 値 (BHID) で指定されたアイテムのハンドラーにバインドします。

構文

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

パラメーター

pbc

種類: IBindCtx*

バインドコンテキストオブジェクトの IBindCtx インターフェイスへのポインター。省略可能なパラメーターをハンドラーに渡すために使用します。バインドコンテキストの内容はハンドラー固有です。たとえば、 BHID_Streamにバインドする場合、バインドコンテキストの STGM フラグは、必要なアクセスモード (読み取りまたは読み取り/書き込み) を示します。

bhid

種類: REFGUID

作成するハンドラーを指定する GUID への参照。 Shlguid.h で定義されている次のいずれかの値。

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 と SP1 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 5.00 以降)

こちらもご覧ください

IShellFolder

Ishellitem