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 エラー コードを返します。
注釈
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shlobj_core.h (Shlobj.h を含む) |
[DLL] | Shell32.dll |