共用方式為


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 資料夾物件的指標。 如果 psfRootNULL,表示傳遞的 IDList 相對於桌面。

[in] pidl

類型: PCUIDLIST_RELATIVE

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

[in] riid

類型: REFIID

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

[out] ppv

類型: void**

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

[out, optional] ppidlLast

類型: PCUITEMID_CHILD*

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

傳回值

類型: HRESULT

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

備註

注意呼叫 SHBindToFolderIDListParent 函式相當於使用 NULL 作為系結內容呼叫 SHBindToFolderIDListParentEx 函式。
 

規格需求

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

另請參閱

SHBindToFolderIDListParentEx