Bagikan melalui

Fungsi ConnectToConnectionPoint (shlwapi.h)

  • Artikel

[Fungsi ini tersedia melalui Windows XP dan Windows Server 2003. Ini mungkin diubah atau tidak tersedia dalam versi Windows berikutnya.]

Menetapkan atau mengakhiri koneksi antara sink klien dan kontainer titik koneksi.

Sintaks

LWSTDAPI ConnectToConnectionPoint(
  [in, optional]  IUnknown         *punk,
  [in]            REFIID           riidEvent,
                  BOOL             fConnect,
  [in]            IUnknown         *punkTarget,
  [out]           DWORD            *pdwCookie,
  [out, optional] IConnectionPoint **ppcpOut
);

Parameter

[in, optional] punk

Jenis: IUnknown*

Penunjuk ke antarmuka IUnknown objek yang akan disambungkan ke kontainer titik koneksi. Jika Anda mengatur fConnect ke FALSE untuk menunjukkan bahwa Anda memutuskan sambungan objek, parameter ini diabaikan dan dapat diatur ke NULL.

[in] riidEvent

Jenis: REFIID

IID antarmuka pada kontainer titik koneksi yang objek titik koneksinya sedang diminta.

fConnect

Jenis: BOOL

TRUE jika koneksi sedang dibuat; FALSE jika koneksi sedang rusak.

[in] punkTarget

Jenis: IUnknown*

Penunjuk ke antarmuka IUnknown kontainer titik koneksi.

[out] pdwCookie

Jenis: DWORD*

Token koneksi. Jika Anda mengatur fConnect ke TRUE untuk membuat koneksi baru, parameter ini menerima token yang secara unik mengidentifikasi koneksi. Jika Anda mengatur fConnect ke FALSE untuk memutuskan koneksi, parameter ini harus menunjuk ke token yang Anda terima saat Anda memanggil ConnectToConnectionPoint untuk membuat koneksi.

[out, optional] ppcpOut

Jenis: IConnectionPoint**

Penunjuk ke antarmuka IConnectionPoint kontainer titik koneksi, jika operasi berhasil. Aplikasi panggilan harus merilis pointer ini ketika tidak lagi diperlukan. Jika permintaan tidak berhasil, penunjuk menerima NULL. Parameter ini bersifat opsional dan dapat berupa NULL.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server, Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
DLL Shlwapi.dll (versi 5.0 atau yang lebih baru)