通过

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 标志，这些标志指示要包含在枚举中的成员类型。 如果此值设置为零，则包含对等组的所有成员。

值 含义
PEER_MEMBER_PRESENT
 枚举当前对等组联机的所有成员。

[in] pwzIdentity

Unicode 字符串，其中包含在单项枚举中检索和返回其信息的特定对等方的标识。 如果此参数为 NULL，则检索当前对等组的所有成员。 此参数是必需的。

[out] phPeerEnum

指向包含返回的对等组成员列表的枚举的指针。 此句柄传递到
PeerGetNextItem 用于检索项，其中每个项都表示为指向 PEER_MEMBER 结构的指针。 完成后，将调用 PeerEndEnumeration 以返回枚举使用的内存。 此参数是必需的。

返回值

如果操作成功，则返回S_OK。 否则，该函数返回以下值之一。

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
E_OUTOFMEMORY
 内存不足，无法执行指定的操作。
PEER_E_INVALID_GROUP
 对等组的句柄无效。
 

可以从 Microsoft RSA 基础提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

注解

如果 pwzIdentity 为 NULL，并且 dwFlags 设置为指示本地节点是显式子集的成员，则本地节点始终是枚举中的第一项。

默认情况下，每个成员都会将成员身份信息发布到对等组。 如果 对该 对等方PEER_MEMBER数据设置了 PEER_MEMBER_DATA_OPTIONAL ，则仅当对等方在组内执行操作（例如，发布记录、更新状态或发出 GMC）时，此信息才可用。

要求

要求 值
最低受支持的客户端 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem