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

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

[in, optional] ppbc

類型： IBindCtx*

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

[in] riid

類型： REFIID

所需介面識別碼的參考。 這通常是IID_IShellFolder或IID_IShellFolder2，但可以是目標資料夾所支援的任何專案。

[out] ppv

類型： void**

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

[out, optional] ppidlLast

類型： PCUITEMID_CHILD*

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

傳回值

類型： HRESULT

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

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlobj_core.h (包含 Shlobj.h)
Dll	Shell32.dll

另請參閱

SHBindToFolderIDListParent