IObjectWithSite::GetSite method (ocidl.h)

  • Artikel

Mengambil situs terbaru yang diteruskan menggunakan SetSite.

Sintaks

HRESULT GetSite(
  [in]  REFIID riid,
  [out] void   **ppvSite
);

Parameter

[in] riid

IID penunjuk antarmuka yang harus dikembalikan dalam ppvSite.

[out] ppvSite

Alamat variabel pointer yang menerima pointer antarmuka yang diminta dalam riid. Setelah berhasil kembali, *ppvSite berisi penunjuk antarmuka yang diminta ke situs yang terakhir terlihat di SetSite. Antarmuka tertentu yang dikembalikan tergantung pada argumen riid . Intinya, kedua argumen bertindak identik dengan yang ada di QueryInterface. Jika penunjuk antarmuka yang sesuai tersedia, objek harus memanggil AddRef pada pointer tersebut sebelum berhasil dikembalikan. Jika tidak ada situs yang tersedia, atau antarmuka yang diminta tidak didukung, metode ini harus *ppvSite ke NULL dan mengembalikan kode kegagalan.

Nilai kembali

Metode ini mengembalikan S_OK pada keberhasilan. Kemungkinan nilai pengembalian lainnya termasuk yang berikut ini.

Menampilkan kode Deskripsi
E_FAIL
 Tidak ada situs, dalam hal ini *ppvSite berisi NULL saat dikembalikan.
E_NOINTERFACE
 Ada situs, tetapi tidak mendukung antarmuka yang diminta oleh riid.

Keterangan

E_NOTIMPL tidak diperbolehkan. Objek apa pun yang mengimplementasikan antarmuka ini harus dapat mengembalikan situs terakhir yang terlihat di IObjectWithSite::SetSite.

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 ocidl.h

Lihat juga

IObjectWithSite