Fungsi SHBindToObject (shlobj_core.h)

Artikel
03/02/2024

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

Sintaks

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

Parameter

psf

Jenis: IShellFolder*

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

pidl

Jenis: PCUIDLIST_RELATIVE

Penunjuk ke ITEMIDLIST konstanta 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 ikatan.

riid

Jenis: REFIID

Pengidentifikasi antarmuka yang akan dikembalikan.

[out] ppv

Jenis: batal**

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.

Keterangan

Catatan 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]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
DLL	Shell32.dll

Lihat juga

IShellFolder

IShellFolder::BindToObject

Bagikan melalui