Metode IShellFolder::BindToStorage (shobjidl_core.h)

Meminta penunjuk ke antarmuka penyimpanan objek.

Sintaks

HRESULT BindToStorage(
  [in]  PCUIDLIST_RELATIVE pidl,
  [in]  IBindCtx           *pbc,
  [in]  REFIID             riid,
  [out] void               **ppv
);

Parameter

[in] pidl

Jenis: PCUIDLIST_RELATIVE

Alamat struktur ITEMIDLIST yang mengidentifikasi subfolder relatif terhadap folder induknya. Struktur harus berisi tepat satu struktur SHITEMID diikuti dengan nol yang mengakhiri.

[in] pbc

Jenis: IBindCtx*

Alamat opsional 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.

[in] riid

Jenis: REFIID

IID antarmuka penyimpanan yang diminta. Untuk mengambil penunjuk antarmuka IStream, IStorage, atau IPropertySetStorage , atur riid ke IID_IStream, IID_IStorage, atau IID_IPropertySetStorage.

[out] ppv

Jenis: void**

Alamat yang menerima penunjuk antarmuka yang ditentukan oleh riid. Jika terjadi kesalahan, penunjuk NULL dikembalikan dalam alamat ini.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Ekstensi namespace memiliki opsi untuk memungkinkan aplikasi mengikat ke objek yang mewakili penyimpanan item. Jika opsi ini didukung, IShellFolder::BindToStorage mengembalikan penunjuk antarmuka tertentu yang kemudian dapat digunakan untuk mengakses konten objek. Lihat referensi IMoniker::BindToStorage untuk diskusi lebih lanjut.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)