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
要系結至與 psf 相對之常數 ITEMIDLIST 的指標。 如果 psf 是 NULL,則這是相對於桌面資料夾的絕對 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 |