IOleClientSite::Metode GetContainer (oleidl.h)

Mengambil penunjuk ke kontainer objek.

Sintaks

HRESULT GetContainer(
  [out] IOleContainer **ppContainer
);

Parameter

[out] ppContainer

Alamat variabel pointer IOleContainer yang menerima penunjuk antarmuka ke objek kontainer. Jika terjadi kesalahan, implementasi harus mengatur ppContainer ke NULL.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
OLE_E_NOT_SUPPORTED	Situs klien berada dalam kontainer OLE 1.
E_NOINTERFACE	Kontainer tidak mengimplementasikan antarmuka IOleContainer .

Keterangan

Jika kontainer mendukung tautan ke objek yang disematkan, menerapkan GetContainer memungkinkan klien tautan untuk menghitung objek kontainer dan secara rekursif melintasi hierarki kontainer. Metode ini bersifat opsional tetapi direkomendasikan untuk semua kontainer yang mengharapkan untuk mendukung tautan ke objek yang disematkan.

Klien tautan dapat melintasi hierarki objek dokumen campuran dengan memanggil GetContainer secara rekursif untuk mendapatkan penunjuk ke kontainer sumber tautan; diikuti oleh QueryInterface untuk mendapatkan pointer ke antarmuka IOleObject kontainer dan, akhirnya, IOleObject::GetClientSite untuk mendapatkan situs klien kontainer dalam kontainernya.

Kontainer sederhana yang tidak mendukung tautan ke objek yang disematkan mungkin tidak perlu menerapkan metode ini. Sebaliknya, mereka dapat mengembalikan E_NOINTERFACE dan mengatur ppContainer ke NULL.

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

IOleClientSite