Metode IDataObject::EnumDAdvise (objidl.h)

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

Sintaks

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

Parameter

[out] ppenumAdvise

Penunjuk ke variabel penunjuk IEnumSTATDATA yang menerima penunjuk antarmuka ke objek enumerator baru. Jika implementasi menetapkan *ppenumAdvise ke NULL, tidak ada koneksi untuk menyarankan sink saat ini.

Nilai kembali

Metode ini mengembalikan S_OK jika objek enumerator berhasil dibuat atau tidak ada koneksi. Nilai lain yang mungkin termasuk yang berikut ini.

Menampilkan kode	Deskripsi
E_OUTOFMEMORY	Memori tidak cukup tersedia untuk operasi ini.
OLE_E_ADVISENOTSUPPORTED	Pemberitahuan saran tidak didukung oleh objek ini.

Keterangan

Objek enumerator yang dibuat oleh metode ini mengimplementasikan antarmuka IEnumSTATDATA . IEnumSTATDATA mengizinkan enumerasi data yang disimpan dalam array struktur STATDATA . Masing-masing struktur ini menyediakan informasi tentang satu koneksi penasihat, dan mencakup informasi FORMATETC dan ADVF , serta penunjuk ke sink saran dan token yang mewakili koneksi.

Catatan untuk Penelepon

Disarankan agar Anda menggunakan objek pemegang saran data OLE untuk menangani koneksi penasihat. Dengan pointer yang diperoleh melalui panggilan ke CreateDataAdviseHolder, menerapkan IDataObject::EnumDAdvise menjadi masalah sederhana untuk mendelegasikan panggilan ke IDataAdviseHolder::EnumAdvise. Ini membuat enumerator dan memasok pointer ke implementasi OLE IEnumSTATDATA. Pada saat itu, Anda dapat memanggil metodenya untuk menghitung koneksi saran saat ini.

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

Lihat juga

IDataAdviseHolder::EnumAdvise

IDataObject

IEnumSTATDATA