PeerGetNextItem 函数 (p2p.h)

项目
03/04/2024

PeerGetNextItem 函数从对等枚举返回特定数量的项。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
  [in]      HPEERENUM hPeerEnum,
  [in, out] ULONG     *pCount,
  [out]     PVOID     **pppvItems
);

参数

[in] hPeerEnum

从中检索项的对等枚举的句柄。此句柄由对等枚举函数生成。

[in, out] pCount

指向一个整数的指针，该整数指定要从对等枚举检索的项数。返回时，它包含 ppvItems 中的项数。此参数不能为 NULL。

[out] pppvItems

接收指向指向对等枚举中下一 个 pCount 项的指针数组的指针。数据（例如记录或成员信息块）取决于实际的对等枚举类型。

返回值

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

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

注解

PeerGetNextItem 函数返回以下内容：

等于或小于 pCount 中指定的数量的项。
当数量大于可用项数时，小于指定数量的项的列表。

注意例如，当 pCount 的入站值为 10，枚举的其余值为 5 个项目时，仅返回 5 个项目， pCount 指向的值设置为 5。

必须通过将指针传递到 PeerFreeData 函数的指针数组来释放返回的所有项。

当函数返回并将 pCount 参数设置为 0 (0) 时，将指示枚举的结束。

要求

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