PeerGroupEnumConnections 函数 (p2p.h)

PeerGroupEnumConnections 函数创建对等方上当前处于活动状态的连接枚举。

语法

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

parameters

[in] hGroup

包含要枚举的连接的组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。

[in] dwFlags

指定要枚举的连接类型的标志。 有效值由 PEER_CONNECTION_FLAGS 指定。

[out] phPeerEnum

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

返回值

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

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

 

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

要求

最低受支持的客户端	具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	p2p.h
Library	P2P.lib
DLL	P2P.dll

请参阅

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem