ConnectToConnectionPoint 函式 (shlwapi.h)

[此函式可透過 Windows XP 和 Windows Server 2003 取得。 在後續版本的 Windows 中，它可能會改變或無法使用。

建立或終止用戶端接收與連接點容器之間的連線。

語法

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

參數

[in, optional] punk

類型： IUnknown*

要連接到連接點容器之物件的 IUnknown 介面指標。 如果您將 fConnect 設定為 FALSE ，表示您中斷物件連線，則會忽略此參數，而且可以設定為 NULL。

[in] riidEvent

類型： REFIID

連接點容器上介面的 IID，其要求連接點物件。

fConnect

類型： BOOL

如果 正在建立連線，則為TRUE; 如果 連線中斷，則為 FALSE。

[in] punkTarget

類型： IUnknown*

連接點容器 IUnknown 介面的指標。

[out] pdwCookie

類型： DWORD*

線上令牌。 如果您將 fConnect 設定為 TRUE 以建立新的連線，此參數會收到可唯一識別連線的令牌。 如果您將 fConnect 設定為 FALSE 來中斷連線，此參數必須指向您在呼叫 ConnectToConnectionPoint 時收到的令牌，才能建立連線。

[out, optional] ppcpOut

類型： IConnectionPoint**

如果作業成功，則為連接點容器 IConnectionPoint 介面的指標。 當不再需要此指標時，呼叫端應用程式必須釋放此指標。 如果要求失敗，指標會收到 NULL。 此參數是選擇性的，可以是 NULL。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

規格需求