通过

PeerGroupUpdateRecord 函数 (p2p.h)

  • 项目

PeerGroupUpdateRecord 函数更新特定对等组中的记录。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUpdateRecord(
  [in] HGROUP       hGroup,
  [in] PPEER_RECORD pRecord
);

parameters

[in] hGroup

记录已更新的对等组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。

[in] pRecord

指向包含 hGroup 更新记录的PEER_RECORD结构的指针。 此参数是必需的。

可以更新 PEER_RECORD 中的以下成员。

  • pwzAttributes
  • ftExpiration
  • data
PEER_RECORD中的以下成员必须存在，但不能更改。
  • dwSize
  • id
  • type
  • dwFlags
如果已填充，将忽略以下成员。
  • dwVersion
  • pwzCreatorId
  • pwzModifiedById
  • ftCreation
  • ftLastModified
  • securityData
剩余的成员是可选的。

返回值

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

返回代码 说明
E_INVALIDARG
 指定的参数之一无效。
PEER_E_GROUP_NOT_READY
 对等组未处于可以更新记录的状态，例如，已调用 PeerGroupJoin ，但与对等组数据库的同步未完成。
PEER_E_INVALID_GROUP
 对等组的句柄无效。
PEER_E_NOT_AUTHORIZED
 当前对等标识没有删除记录的授权。 在这种情况下，对等标识不是记录的创建者。
PEER_E_RECORD_NOT_FOUND
 该记录不能位于数据存储区中。
 

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

要求

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

请参阅

PEER_RECORD

PeerGroupAddRecord

PeerGroupCreate

PeerGroupDeleteRecord

PeerGroupJoin

PeerGroupOpen