IConnectionPoint::Metode saran (ocidl.h)

  • Artikel

Membuat koneksi antara objek titik koneksi dan sink klien.

Sintaks

HRESULT Advise(
  [in]  IUnknown *pUnkSink,
  [out] DWORD    *pdwCookie
);

Parameter

[in] pUnkSink

Penunjuk ke antarmuka IUnknown pada sink saran klien. Sink klien menerima panggilan keluar dari titik koneksi.

[out] pdwCookie

Penunjuk ke token yang dikembalikan yang secara unik mengidentifikasi koneksi ini. Penelepon menggunakan token ini nanti untuk menghapus koneksi dengan meneruskannya ke metode IConnectionPoint::Unadvise . Jika koneksi tidak berhasil dibuat, nilai ini adalah nol.

Nilai kembali

Metode ini dapat mengembalikan nilai pengembalian standar E_OUTOFMEMORY dan E_UNEXPECTED, serta nilai berikut.

Menampilkan kode Deskripsi
S_OK
 Koneksi telah dibuat dan *pdwCookie memiliki token koneksi.
E_POINTER
 Nilai dalam pUnkSink atau pdwCookie tidak valid. Misalnya, salah satu penunjuk mungkin NULL.
CONNECT_E_ADVISELIMIT
 Titik koneksi telah mencapai batas koneksinya dan tidak dapat menerima lagi.
CONNECT_E_CANNOTCONNECT
 Sink tidak mendukung antarmuka yang diperlukan oleh titik koneksi ini.

Keterangan

Saran membuat koneksi antara titik koneksi dan sink pemanggil yang diidentifikasi dengan pUnkSink.

Titik koneksi harus memanggil QueryInterface untuk mendapatkan penunjuk antarmuka keluar yang benar untuk memanggil ketika peristiwa terjadi, dengan IID untuk antarmuka keluar yang dikelola oleh titik koneksi. Ketika IID diteruskan ke metode IConnectionPointContainer::FindConnectionPoint , penunjuk antarmuka ke titik koneksi yang sama ini dikembalikan.

Catatan untuk Pelaksana

Titik koneksi harus mengkueri penunjuk pUnkSink untuk antarmuka keluar yang benar. Jika kueri ini gagal, metode ini harus mengembalikan CONNECT_E_CANNOTCONNECT.

Nilai pdwCookie harus unik untuk setiap koneksi ke instans tertentu dari titik koneksi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header ocidl.h

Lihat juga

IConnectionPoint