IObjectWithSite::GetSite method (ocidl.h)
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 |
---|---|
|
Tidak ada situs, dalam hal ini *ppvSite berisi NULL saat dikembalikan. |
|
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 |