Bagikan melalui

Menggunakan I Koneksi ionPoint

  • Artikel

Ketika klien memiliki penunjuk ke titik koneksi, klien dapat melakukan operasi berikut seperti yang dinyatakan melalui I Koneksi ionPoint:

  • Pertama, I Koneksi ionPoint::Get Koneksi ionInterface mengambil IID antarmuka keluar yang didukung oleh titik koneksi. Ketika digunakan bersama dengan IEnum Koneksi ionPoints, metode ini memungkinkan klien untuk memeriksa IID semua antarmuka keluar yang didukung pada objek yang dapat dihubungkan.
  • Kedua, klien dapat menavigasi dari titik koneksi kembali ke antarmuka I Koneksi ionPointContainer objek yang dapat dihubungkan melalui metode I Koneksi ionPoint::Get Koneksi ionPointContainer.
  • Ketiga, metode yang paling menarik untuk klien adalah I Koneksi ionPoint::Advise and I Koneksi ionPoint::Unadvise. Ketika klien ingin menyambungkan objek sinknya sendiri ke objek yang dapat dihubungkan, klien meneruskan pointer IUnknown sink (atau penunjuk antarmuka lainnya pada objek yang sama) ke Advise. Titik koneksi meminta sink untuk antarmuka keluar tertentu yang diharapkan. Jika antarmuka tersebut tersedia di sink, titik koneksi kemudian menyimpan penunjuk antarmuka. Dari titik ini sampai Unadvise dipanggil, objek yang dapat dihubungkan akan melakukan panggilan ke sink melalui antarmuka ini ketika peristiwa terjadi. Untuk memutuskan sambungan sink dari titik koneksi, klien meneruskan kunci yang dikembalikan dari Advise ke metode Unadvise . Unadvise harus memanggil Rilis pada antarmuka sink.
  • Terakhir, klien dapat meminta titik koneksi untuk menghitung semua koneksi yang ada melalui I Koneksi ionPoint::Enum Koneksi ions. Metode ini membuat objek enumerator (dengan jumlah referensi terpisah) yang mengembalikan pointer IEnum Koneksi ions ke objek tersebut. Klien harus memanggil Rilis ketika enumerator tidak lagi diperlukan. Selain itu, enumerator mengembalikan serangkaian struktur CONNECTDATA , satu untuk setiap koneksi. Setiap struktur menjelaskan satu koneksi menggunakan pointer IUnknown sink serta kunci koneksi yang awalnya dikembalikan dari Advise. Setelah selesai dengan penunjuk antarmuka sink ini, klien harus memanggil Rilis pada setiap pointer yang dikembalikan dalam struktur CONNECTDATA .

Antarmuka Objek yang Dapat Koneksi