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 は、親フォルダーのインターフェイスでサポートされているメソッドの多くで使用できます。 ppidlLastNULL に設定した場合、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 以降)