SHBindToObject 関数 (shlobj_core.h)

  • [アーティクル]

シェル名前空間 IShellFolder::BindToObject メソッドを使用して、指定したオブジェクトを取得してバインドします。

構文

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

パラメーター

psf

種類: IShellFolder*

IShellFolder へのポインター。 このパラメーターは、NULL でもかまいません。 psf が NULL の場合、これはパラメーター pidl がデスクトップに対して相対的であることを示します。 この場合、 pidl は絶対 ITEMIDLIST を指定する必要があります。

pidl

種類: PCUIDLIST_RELATIVE

psf を基準にしてバインドする定数 ITEMIDLIST へのポインター。 psf が NULL の場合、これはデスクトップ フォルダーに対する絶対 ITEMIDLIST です。

[in] pbc

型: IBindCtx*

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

riid

型: REFIID

返すインターフェイスの識別子。

[out] ppv

型: void**

このメソッドから制御が戻るときに、バインドされたオブジェクトへの riid で指定されたインターフェイス ポインターが格納されます。 エラーが発生した場合は、 に NULL ポインターが含まれます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

メモ これは、 SHGetDesktopFolder を呼び出してデスクトップ オブジェクトを取得するヘルパー関数です。
 

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlobj_core.h (Shlobj.h を含む)
[DLL] Shell32.dll

こちらもご覧ください

IShellFolder

IShellFolder::BindToObject