IOleObject::GetClientSite method (oleidl.h)

  • Artikel

Mengambil penunjuk ke situs klien objek yang disematkan.

Sintaks

HRESULT GetClientSite(
  [out] IOleClientSite **ppClientSite
);

Parameter

[out] ppClientSite

Alamat variabel pointer IOleClientSite yang menerima penunjuk antarmuka ke situs klien objek. Jika objek belum mengetahui situs kliennya, atau jika terjadi kesalahan, ppClientSite harus diatur ke NULL. Setiap kali objek menerima panggilan ke IOleObject::GetClientSite, objek harus meningkatkan jumlah referensi pada ppClientSite. Pemanggil bertanggung jawab untuk memanggil Release ketika dilakukan dengan ppClientSite.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan.

Keterangan

Klien Link paling sering memanggil metode IOleObject::GetClientSite bersama dengan metode IOleClientSite::GetContainer untuk melintasi hierarki objek berlapis. Klien tautan memanggil IOleObject::GetClientSite untuk mendapatkan penunjuk ke situs klien sumber tautan. Klien kemudian memanggil IOleClientSite::GetContainer untuk mendapatkan penunjuk ke kontainer sumber tautan. Terakhir, klien memanggil QueryInterface untuk mendapatkan IOleObject dan IOleObject::GetClientSite untuk mendapatkan situs klien kontainer dalam kontainernya. Dengan mengulangi urutan panggilan ini, penelepon akhirnya dapat mengambil penunjuk ke kontainer master tempat semua objek lain ditumpuk.

Catatan untuk Penelepon

Penunjuk situs klien yang dikembalikan akan menjadi NULL jika objek yang disematkan belum diberi tahu tentang situs kliennya. Ini akan menjadi kasus dengan objek yang baru dimuat atau dibuat ketika kontainer telah meneruskan penunjuk situs klien NULL ke salah satu fungsi pembantu pembuatan objek tetapi belum memanggil IOleObject::SetClientSite sebagai bagian dari inisialisasi objek.

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

IOleObject

IOleObject::SetClientSite