IShellFolder::BindToStorage メソッド (shobjidl_core.h)

オブジェクトのストレージ インターフェイスへのポインターを要求します。

構文

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

パラメーター

[in] pidl

種類: PCUIDLIST_RELATIVE

親フォルダーを基準としたサブフォルダーを識別する ITEMIDLIST 構造体のアドレス。 構造体には、1 つの SHITEMID 構造体の後に終端の 0 が続く必要があります。

[in] pbc

型: IBindCtx*

この操作中に使用されるバインド コンテキスト オブジェクト上の IBindCtx インターフェイスの省略可能なアドレス。 このパラメーターを使用しない場合は、NULL に設定 します。 pbc のサポートはフォルダー オブジェクトの実装では省略可能であるため、一部のフォルダーではバインド コンテキストの使用がサポートされない場合があります。

[in] riid

型: REFIID

要求されたストレージ インターフェイスの IID。 IStream、IStorage、または IPropertySetStorage インターフェイス ポインターを取得するには、それぞれ riid を IID_IStream、IID_IStorage、またはIID_IPropertySetStorageに設定します。

[out] ppv

型: void**

riid で指定されたインターフェイス ポインターを受け取るアドレス。 エラーが発生した場合は、このアドレスに NULL ポインターが返されます。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

名前空間拡張には、アプリケーションが項目のストレージを表すオブジェクトにバインドできるようにするオプションがあります。 このオプションがサポートされている場合、 IShellFolder::BindToStorage は指定されたインターフェイス ポインターを返し、それを使用してオブジェクトの内容にアクセスできます。 詳細については、 IMoniker::BindToStorage リファレンスを参照してください。

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shobjidl_core.h (Shobjidl.h を含む)
[DLL]	Shell32.dll (バージョン 4.0 以降)