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 版或更新版本)