SHBindToFolderIDListParent 函式 （shlobj_core.h）

假設以資料夾形式指定的 Shell 命名空間專案，以及相對於該資料夾的專案識別碼清單，此函式會系結至命名空間專案的父系，並選擇性地傳回專案識別碼清單最終元件的指標。

語法

SHSTDAPI SHBindToFolderIDListParent(
  [in, optional]  IShellFolder       *psfRoot,
  [in]            PCUIDLIST_RELATIVE pidl,
  [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] riid

類型： REFIID

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

[out] ppv

類型： 無效**

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

[out, optional] ppidlLast

類型： PCUITEMID_CHILD*

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

返回值

類型：HRESULT

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

備註

需求

另請參閱

SHBindToFolderIDListParentEx