Metode IOleObject::EnumAdvise (oleidl.h)
Mengambil penunjuk ke enumerator yang dapat digunakan untuk menghitung koneksi penasihat yang terdaftar untuk objek, sehingga kontainer dapat mengetahui apa yang harus dilepaskan sebelum menutup.
Sintaks
HRESULT EnumAdvise(
[out] IEnumSTATDATA **ppenumAdvise
);
Parameter
[out] ppenumAdvise
Alamat variabel penunjuk IEnumSTATDATA yang menerima penunjuk antarmuka ke objek enumerator. Jika objek tidak memiliki koneksi saran atau jika terjadi kesalahan, implementasi harus mengatur ppenumAdvise ke NULL. Setiap kali objek menerima panggilan yang berhasil ke IOleObject::EnumAdvise, objek harus meningkatkan jumlah referensi pada ppenumAdvise. Adalah tanggung jawab pemanggil untuk memanggil Rilis ketika selesai dengan ppenumAdvise.
Nilai kembali
Metode ini mengembalikan S_OK pada keberhasilan. Nilai pengembalian lain yang mungkin termasuk yang berikut ini.
| Menampilkan kode | Deskripsi |
|---|---|
|
IOleObject::EnumAdvise tidak diimplementasikan. |
Keterangan
Metode IOleObject::EnumAdvise menyediakan enumerator yang menyediakan cara bagi kontainer untuk melacak koneksi saran yang terdaftar untuk objek mereka. Kontainer biasanya akan memanggil fungsi ini sehingga dapat menginstruksikan objek untuk merilis setiap koneksi penasihatnya sebelum menutup.
Enumerator tempat Anda mendapatkan akses melalui IOleObject::EnumAdvise menghitung item jenis STATDATA. Setelah menerima penunjuk, kontainer kemudian dapat mengulang melalui STATDATA dan memanggil IOleObject::Unadvise untuk setiap koneksi yang dijumlahkan.
Cara biasa untuk mengimplementasikan fungsi ini adalah dengan mendelegasikan panggilan ke antarmuka IOleAdviseHolder . Hanya anggota pAdvise dan dwConnectionstatDATA yang relevan untuk IOleObject::EnumAdvise.
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 |