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

類型： 布爾值

如果正在建立連線，則為 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 錯誤碼。

需求