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 |
---|---|
|
Memori tidak cukup tersedia untuk operasi ini. |
|
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 |