Fungsi SHBindToObject (shlobj_core.h)

Mengambil dan mengikat ke objek tertentu dengan menggunakan metode Shell namespace IShellFolder::BindToObject .

Syntax

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

Parameter-parameternya

psf

Jenis: IShellFolder*

Penunjuk ke IShellFolder. Parameter ini dapat null. Jika psfNULL, ini menunjukkan parameter pidl relatif terhadap desktop. Dalam hal ini, pidl harus menentukan ITEMIDLIST absolut.

pidl

Jenis: PCUIDLIST_RELATIVE

Pointer ke ITEMIDLIST konstan untuk mengikat yang relatif terhadap psf. Jika psfNULL, ini adalah ITEMIDLIST absolut relatif terhadap folder desktop.

[in] pbc

Jenis: IBindCtx*

Penunjuk ke antarmuka IBindCtx pada objek konteks ikatan yang akan digunakan selama operasi ini. Jika parameter ini tidak digunakan, atur ke NULL. Karena dukungan untuk pbc bersifat opsional untuk implementasi objek folder, beberapa folder mungkin tidak mendukung penggunaan konteks pengikatan.

riid

Jenis: REFIID

Pengidentifikasi antarmuka yang akan dikembalikan.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi penunjuk antarmuka seperti yang ditentukan dalam riid ke objek terikat. Jika terjadi kesalahan, berisi penunjuk NULL .

Mengembalikan nilai

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Komentar

Nota Ini adalah fungsi pembantu yang mendapatkan objek desktop dengan memanggil SHGetDesktopFolder.

 

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Library	OneCore.Lib
DLL	Shell32.dll

Lihat juga

IShellFolder

IShellFolder::BindToObject