SHBindToObject 函式 （shlobj_core.h）

使用 Shell 命名空間 IShellFolder：：BindToObject 方法擷取並系結至指定的物件。

語法

SHSTDAPI SHBindToObject(
        IShellFolder       *psf,
        PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
        REFIID             riid,
  [out] void               **ppv
);

參數

psf

類型： IShellFolder*

IShellFolder 的指標。 此參數可以是 NULL。 如果 psf 為 Null，則表示參數 pidl 相對於桌面。 在此情況下， pidl 必須指定絕對 ITEMIDLIST。

pidl

類型： PCUIDLIST_RELATIVE

要系結的常數 ITEMIDLIST 指標相對於 psf。 如果 psf 為 Null，則這是相對於桌面資料夾的絕對 ITEMIDLIST 。

[in] pbc

類型： IBindCtx*

在此作業期間要使用的系結內容物件上 IBindCtx 介面的指標。 如果未使用此參數，請將其設定為 NULL。 因為資料夾物件實作對 pbc 的支援是選擇性的，所以某些資料夾可能不支援使用系結內容。

riid

類型： REFIID

要傳回的介面識別碼。

[out] ppv

類型： 無效**

當這個方法傳回時，包含 riid 中指定的介面指標，指向繫結物件。 如果發生錯誤，則包含 NULL 指標。

返回值

類型：HRESULT

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

備註

需求

另請參閱

IShellFolder

IShellFolder：：BindToObject