peerGroupEnumRecords 函数 (p2p.h)

PeerGroupEnumRecords 函数创建对等组记录的枚举。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumRecords(
  [in]  HGROUP     hGroup,
  [in]  const GUID *pRecordType,
  [out] HPEERENUM  *phPeerEnum
);

parameters

[in] hGroup

枚举其记录的对等组的句柄。 此句柄由 PeerGroupCreatePeerGroupOpenPeerGroupJoin 函数返回。 此参数是必需的。

[in] pRecordType

指向唯一标识特定记录类型的 GUID 值的指针。 如果此参数为 NULL,则返回所有记录。

[out] phPeerEnum

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

返回值

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

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

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

要求

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

请参阅

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem

PeerGroupGetRecord