Metode IOleItemContainer::GetObjectStorage (oleidl.h)

Artikel
03/13/2024

Mengambil pointer ke penyimpanan untuk objek yang ditentukan.

Sintaks

HRESULT GetObjectStorage(
  [in]  LPOLESTR pszItem,
  [in]  IBindCtx *pbc,
  [in]  REFIID   riid,
  [out] void     **ppvStorage
);

Parameter

[in] pszItem

Nama dokumen gabungan untuk objek yang penyimpanannya diminta.

[in] pbc

Penunjuk ke antarmuka IBindCtx pada konteks ikatan yang akan digunakan dalam operasi pengikatan ini. Konteks ikatan menyimpan objek yang terikat selama proses pengikatan, berisi parameter yang berlaku untuk semua operasi menggunakan konteks ikatan, dan menyediakan sarana di mana implementasi pengikatan harus mengambil informasi tentang lingkungannya.

[in] riid

Referensi ke pengidentifikasi antarmuka yang akan digunakan untuk berkomunikasi dengan objek, biasanya IStorage.

[out] ppvStorage

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil dikembalikan, *ppvStorage berisi penunjuk antarmuka yang diminta ke penyimpanan untuk objek yang dinamai oleh pszItem. Jika berhasil, implementasi harus memanggil AddRef pada *ppvStorage; adalah tanggung jawab penelepon untuk memanggil Rilis. Jika terjadi kesalahan, *ppvStorage diatur ke NULL.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY, serta nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Metode ini berhasil sepenuhnya.
MK_E_OBJECT	Parameter pszItem tidak mengidentifikasi objek dalam kontainer ini.
MK_E_NOSTORAGE	Objek tidak memiliki penyimpanan independen sendiri.
E_NOINTERFACE	Antarmuka yang diminta tidak tersedia.

Keterangan

Implementasi item moniker dari IMoniker::BindToStorage memanggil metode ini.

Catatan untuk Pelaksana

Jika pszItem menunjuk objek pseudo, implementasi IOleItemContainer::GetObjectStorage Anda harus mengembalikan MK_E_NOSTORAGE, karena objek semu tidak memiliki penyimpanan independennya sendiri. Jika pszItem menunjuk objek yang disematkan, atau sebagian dokumen yang memiliki penyimpanannya sendiri, implementasi Anda harus mengembalikan penunjuk antarmuka yang ditentukan pada objek penyimpanan yang sesuai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	oleidl.h

Lihat juga

IOleItemContainer

Bagikan melalui