PeerGroupEnumConnections 関数 (p2p.h)

  • [アーティクル]

PeerGroupEnumConnections 関数は、ピアで現在アクティブな接続の列挙体を作成します。

構文

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumConnections(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

パラメーター

[in] hGroup

列挙する接続を含むグループを処理します。 このハンドルは、 PeerGroupCreate、 PeerGroupOpen、または PeerGroupJoin 関数によって返されます。 このパラメーターは必須です。

[in] dwFlags

列挙する接続の種類を示すフラグを指定します。 有効な値は 、PEER_CONNECTION_FLAGSによって指定されます。

[out] phPeerEnum

返されたアクティブな接続の一覧を含む列挙へのポインター。 このハンドルは に渡されます。
PeerGetNextItem を使用して項目を取得します。各項目は 、PEER_CONNECTION_INFO 構造体へのポインターとして表されます。 完了すると、 PeerEndEnumeration が呼び出され、 列挙体によって使用されるメモリが返されます。 このパラメーターは必須です。

戻り値

操作が成功した場合S_OKを返します。 それ以外の場合、関数は次のいずれかの値を返します。

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_INVALID_GROUP
 ピア グループへのハンドルが無効です。
 

暗号化固有のエラーは、 Microsoft RSA ベース プロバイダーから返すことができます。 これらのエラーの前には CRYPT_* が付き、Winerror.h で定義されています。

要件

   
サポートされている最小のクライアント Windows XP と SP2 [デスクトップ アプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2P.lib
[DLL] P2P.dll

関連項目

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem