IConnectionPointContainer::EnumConnectionPoints メソッド (ocidl.h)
接続可能なオブジェクトでサポートされているすべての接続ポイント (発信 IID ごとに 1 つの接続ポイント) を反復処理する列挙子オブジェクトを作成します。
構文
HRESULT EnumConnectionPoints(
[out] IEnumConnectionPoints **ppEnum
);
パラメーター
[out] ppEnum
新しく作成された列挙子へのポインターを受け取る IEnumConnectionPoints インターフェイス ポインター変数へのポインター。
戻り値
このメソッドは、E_OUTOFMEMORYおよびE_UNEXPECTED標準の戻り値と、次の値を返すことができます。
リターン コード | 説明 |
---|---|
|
列挙子オブジェクトが正常に作成されました。 |
|
ppEnum のアドレスが無効です。 たとえば、 NULL にすることができます。 |
注釈
IEnumConnectionPoints は IConnectionPoint へのポインターを列挙するため、呼び出し元は IConnectionPoint::GetConnectionInterface を使用して、接続ポイントがサポートする発信インターフェイスのインターフェイス識別子を決定する必要があります。
呼び出し元へのメモ
列挙子が不要になった場合、呼び出し元は Release を呼び出す必要があります。実装者へのメモ
型情報を除き、呼び出し元が発信インターフェイスの IID を検出できる他の手段がないため、E_NOTIMPLの返しは特に禁止されています。 接続可能なオブジェクトには通常、既知の発信インターフェイスの固定セットがあるため、コンパイル時に既知の固定長の ID 配列の上に列挙子を実装するのは簡単です。要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | ocidl.h |