SHBindToParent 関数 (shlobj_core.h)
完全修飾項目識別子リスト (PIDL) へのポインターを受け取り、親オブジェクトに対して指定されたインターフェイス ポインターを返します。
構文
SHSTDAPI SHBindToParent(
[in] PCIDLIST_ABSOLUTE pidl,
[in] REFIID riid,
[out] void **ppv,
[out] PCUITEMID_CHILD *ppidlLast
);
パラメーター
[in] pidl
種類: PCIDLIST_ABSOLUTE
項目の PIDL。
[in] riid
型: REFIID
項目の親オブジェクトによって公開されるインターフェイスの 1 つの REFIID 。
[out] ppv
型: VOID**
riid で指定されたインターフェイスへのポインター。 完了したら、オブジェクトを解放する必要があります。
[out] ppidlLast
種類: PCUITEMID_CHILD*
親フォルダーに対する相対的な項目の PIDL。 この PIDL は、親フォルダーのインターフェイスでサポートされているメソッドの多くで使用できます。 ppidlLast を NULL に設定した場合、PIDL は返されません。
注SHBindToParent では、新しい PIDL は割り当てられません。このパラメーターを介してポインターを受け取るだけです。 そのため、このリソースを解放する責任はありません。
戻り値
型: HRESULT
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional、Windows XP [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | shlobj_core.h (Shlobj.h を含む) |
Library | Shell32.lib |
[DLL] | Shell32.dll (バージョン 5.0 以降) |