peerGroupGetRecord 函数 (p2p.h)

项目
08/25/2023

PeerGroupGetRecord 函数检索特定的组记录。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

parameters

[in] hGroup

包含特定记录的组的句柄。此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。此参数是必需的。

[in] pRecordId

指定唯一标识对等组中所需记录的 GUID 值。此参数是必需的。

[out] ppRecord

指向包含返回记录的 PEER_RECORD 结构的地址的指针。此结构通过将指针传递给 PeerFreeData 来释放。此参数是必需的。

返回值

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

返回代码	说明
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	内存不足，无法执行指定的操作。
PEER_E_GROUP_NOT_READY	对等组未处于可检索组记录的状态。例如，调用 PeerGroupJoin ，但尚未完成与对等组数据库的同步。
PEER_E_INVALID_GROUP	对等组的句柄无效。
PEER_E_RECORD_NOT_FOUND	在对等组数据库中找不到与提供的 ID 匹配的记录。

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

要求


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