PeerGroupEnumMembers 関数 (p2p.h)

  • [アーティクル]

PeerGroupEnumMembers 関数は、使用可能なピア グループ メンバーと関連付けられたメンバーシップ情報の列挙を作成します。

構文

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

パラメーター

[in] hGroup

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

[in] dwFlags

列挙に含めるメンバーの型を示す PEER_MEMBER_FLAGS フラグを指定します。 この値を 0 に設定すると、ピア グループのすべてのメンバーが含まれます。

値 意味
PEER_MEMBER_PRESENT
 オンラインになっている現在のピア グループのすべてのメンバーを列挙します。

[in] pwzIdentity

情報が取得され、1 項目列挙で返される特定のピアの ID を含む Unicode 文字列。 このパラメーターが NULL の場合、現在のピア グループのすべてのメンバーが取得されます。 このパラメーターは必須です。

[out] phPeerEnum

ピア グループ メンバーの返されたリストを含む列挙へのポインター。 このハンドルは に渡されます。
PeerGetNextItem を使用して項目を取得します。各項目は 、PEER_MEMBER 構造体へのポインターとして表されます。 完了すると、 PeerEndEnumeration が呼び出され、 列挙体によって使用されるメモリが返されます。 このパラメーターは必須です。

戻り値

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

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

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

注釈

pwzIdentity が NULL の場合、ローカル ノードは常に列挙体の最初の項目であり、ローカル ノードが明示的なサブセットのメンバーであることを示すように dwFlags が設定されます。

既定では、すべてのメンバーがピア グループにメンバーシップ情報を発行します。 PEER_MEMBER_DATA_OPTIONALがそのピアのPEER_MEMBER データに設定されている場合、この情報は、ピアがグループ内のアクション (レコードの公開、プレゼンスの更新、GMC の発行など) を実行する場合にのみ使用できます。

要件

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

こちらもご覧ください

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem