SHBindToParent 函式 (shlobj_core.h)

將指標指向完整專案標識符清單, (PIDL) ,並在父對象上傳回指定的介面指標。

語法

SHSTDAPI SHBindToParent(
  [in]  PCIDLIST_ABSOLUTE pidl,
  [in]  REFIID            riid,
  [out] void              **ppv,
  [out] PCUITEMID_CHILD   *ppidlLast
);

參數

[in] pidl

類型: PCIDLIST_ABSOLUTE

專案的 PIDL。

[in] riid

類型: REFIID

專案父物件所公開其中一個介面的 REFIID

[out] ppv

類型: VOID**

riid 所指定介面的指標。 完成時,您必須釋放 物件。

[out] ppidlLast

類型: PCUITEMID_CHILD*

相對於父資料夾的專案 PIDL。 此 PIDL 可以搭配父資料夾介面所支援的許多方法使用。 如果您將 ppidlLast 設定為 NULL,則不會傳回 PIDL。

注意SHBindToParent 未配置新的 PIDL;它只會透過此參數接收指標。 因此,您不負責釋放此資源。
 

傳回值

類型: HRESULT

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

規格需求

需求
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
程式庫 Shell32.lib
Dll Shell32.dll (5.0 版或更新版本)