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 エラー コードを返します。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server、Windows Server 2003 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	shlwapi.h
[DLL]	Shlwapi.dll (バージョン 5.0 以降)