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
要系結至的 PIDL,相對於 psfRoot。 如果 psfRoot 是 NULL,則這是相對於桌面資料夾的絕對 IDList。
[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 錯誤碼。
備註
注意呼叫 SHBindToFolderIDListParent 函式相當於使用 NULL 作為系結內容呼叫 SHBindToFolderIDListParentEx 函式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | shlobj_core.h (包含 Shlobj.h) |
Dll | Shell32.dll |