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

  • [アーティクル]

接続可能なオブジェクトでサポートされているすべての接続ポイント (発信 IID ごとに 1 つの接続ポイント) を反復処理する列挙子オブジェクトを作成します。

構文

HRESULT EnumConnectionPoints(
  [out] IEnumConnectionPoints **ppEnum
);

パラメーター

[out] ppEnum

新しく作成された列挙子へのポインターを受け取る IEnumConnectionPoints インターフェイス ポインター変数へのポインター。

戻り値

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

リターン コード 説明
S_OK
 列挙子オブジェクトが正常に作成されました。
E_POINTER
 ppEnum のアドレスが無効です。 たとえば、 NULL にすることができます。

注釈

IEnumConnectionPoints は IConnectionPoint へのポインターを列挙するため、呼び出し元は IConnectionPoint::GetConnectionInterface を使用して、接続ポイントがサポートする発信インターフェイスのインターフェイス識別子を決定する必要があります。

呼び出し元へのメモ

列挙子が不要になった場合、呼び出し元は Release を呼び出す必要があります。

実装者へのメモ

型情報を除き、呼び出し元が発信インターフェイスの IID を検出できる他の手段がないため、E_NOTIMPLの返しは特に禁止されています。 接続可能なオブジェクトには通常、既知の発信インターフェイスの固定セットがあるため、コンパイル時に既知の固定長の ID 配列の上に列挙子を実装するのは簡単です。

要件

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

関連項目

IConnectionPointContainer

IEnumConnectionPoints