共用方式為


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。 如果 psfNULL,這表示參數 pidl 相對於桌面。 在此情況下, pidl 必須指定絕對 ITEMIDLIST

pidl

類型: PCUIDLIST_RELATIVE

要系結至與 psf 相對之常數 ITEMIDLIST 的指標。 如果 psfNULL,則這是相對於桌面資料夾的絕對 ITEMIDLIST

[in] pbc

類型: IBindCtx*

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

riid

類型: REFIID

要傳回之介面的標識碼。

[out] ppv

類型: void**

當這個方法傳回時,會包含與系結物件 之 riid 中所指定的介面指標。 如果發生錯誤,則包含 NULL 指標。

傳回值

類型: HRESULT

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

備註

注意 這是協助程式函式,可藉由呼叫 SHGetDesktopFolder來取得桌面物件。
 

規格需求

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

另請參閱

IShellFolder

IShellFolder::BindToObject