SHBindToFolderIDListParentEx 函式 （shlobj_core.h）

允許呼叫端指定系結內容，藉由擴充 SHBindToFolderIDListParent 函式。

語法

SHSTDAPI SHBindToFolderIDListParentEx(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [in, optional]  IBindCtx           *ppbc,
  [in]            REFIID             riid,
  [out]           void               **ppv,
  [out, optional] PCUITEMID_CHILD    *ppidlLast
);

參數

[in, optional] psfRoot

類型： IShellFolder*

Shell 資料夾物件的指標。 如果 psfRoot 為 Null，則表示傳遞的 IDList 相對於桌面。

[in] pidl

類型： PCUIDLIST_RELATIVE

相對於 psfRoot 要系結的 PIDL。 如果 psfRoot 為 Null，則這是相對於桌面資料夾的絕對 IDList。

[in, optional] ppbc

類型： IBindCtx*

在此作業期間要使用的系結內容物件上 IBindCtx 介面的指標。 如果未使用此參數，請將它設定為 NULL，這相當於呼叫 SHBindToFolderIDListParent 函式。 因為資料夾物件實作對 pbc 的支援是選擇性的，所以某些資料夾可能不支援使用系結內容。

[in] riid

類型： REFIID

對所需介面 ID 的引用。 這通常是IID_IShellFolder或IID_IShellFolder2，但可以是目標資料夾支援的任何內容。

[out] ppv

類型： 無效**

當此函式傳回時，包含 riid 中要求的介面指標。 這通常是 IShellFolder 或 IShellFolder2，但可以是目標資料夾支援的任何專案。

[out, optional] ppidlLast

類型： PCUITEMID_CHILD*

pidl 參數最後一個識別碼的指標，是相對於 ppv 中傳回的父資料夾的子識別碼。 這個值可以 NULL。

返回值

類型：HRESULT

如果函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

需求

另請參閱

SHBindToFolderIDListParent