IOleAdviseHolder::Metode EnumAdvise (oleidl.h)

Artikel
03/01/2024

Membuat enumerator yang dapat digunakan untuk menghitung koneksi penasihat yang saat ini dibuat untuk objek.

Sintaks

HRESULT EnumAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Parameter

[out] ppenumAdvise

Penunjuk ke variabel penunjuk IEnumSTATDATA yang menerima penunjuk antarmuka ke enumerator baru. Jika parameter ini NULL, saat ini tidak ada koneksi penasihat pada objek, atau terjadi kesalahan. Pemegang saran bertanggung jawab untuk meningkatkan jumlah referensi pada pointer IEnumSTATDATA yang disediakan metode ini. Adalah tanggung jawab penelepon untuk memanggil IUnknown::Release ketika selesai dengan pointer.

Nilai kembali

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

Menampilkan kode	Deskripsi
E_FAIL	Operasi enumerasi gagal.
E_NOTIMPL	IOleAdviseHolder::EnumAdvise tidak diimplementasikan.

Keterangan

IOleAdviseHolder::EnumAdvise membuat enumerator yang dapat digunakan untuk menghitung koneksi nasihat yang ditetapkan objek. Metode ini memasok pointer ke antarmuka IEnumSTATDATA pada enumerator ini. Informasi koneksi saran untuk setiap koneksi disimpan dalam struktur STATDATA , dan enumerator harus dapat menghitung struktur ini.

Untuk metode ini, satu-satunya anggota struktur yang relevan adalah pAdvise dan dwConnection. Anggota lain berisi informasi saran data. Ketika Anda memanggil metode enumerasi, dan saat enumerasi sedang berlangsung, efek mendaftarkan atau mencabut koneksi saran tentang apa yang akan dijumlahkan tidak terdefinisi.

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