IConnectionPointContainer::FindConnectionPoint メソッド (ocidl.h)

  • [アーティクル]

指定した IID の接続ポイントの IConnectionPoint インターフェイスへのポインターを返します(その IID でサポートされている送信インターフェイスが記述されている場合)。

構文

HRESULT FindConnectionPoint(
  [in]  REFIID           riid,
  [out] IConnectionPoint **ppCP
);

パラメーター

[in] riid

接続ポイント オブジェクトが要求されている発信インターフェイスのインターフェイス識別子。

[out] ppCP

riid インターフェイスをサポートする接続ポイントへのポインターを受け取る IConnectionPoint インターフェイス ポインター変数のアドレス。 エラーが発生した場合、実装は値を NULL に設定 します。

戻り値

このメソッドは、E_OUTOFMEMORYおよびE_UNEXPECTED標準の戻り値と、次の値を返すことができます。

リターン コード 説明
S_OK
 メソッドは正常に完了しました。
E_POINTER
 ppCP 内のアドレスが無効です。 たとえば、 NULL にすることができます。
CONNECT_E_NOCONNECTION
 この接続可能なオブジェクトは、 riid で指定された出力インターフェイスをサポートしていません。

注釈

このメソッドは、オブジェクトの送信インターフェイスに相当する QueryInterface です。送信インターフェイスは riid で指定され、返されるインターフェイス ポインターは常に接続ポイントのインターフェイス ポインターです。

呼び出し元へのメモ

呼び出しが成功した場合、呼び出し元は、接続ポイントが不要になったときに Release を呼び出すことによって、接続ポイントを解放する必要があります。

実装者へのメモ

E_NOTIMPLは、このメソッドの戻り値として使用できません。 IConnectionPointContainer の実装では、接続可能なオブジェクトの送信インターフェイスに対してこのメソッドを実装する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー ocidl.h

関連項目

IConnectionPoint

IConnectionPointContainer