PeerGroupDeleteRecord 函数 (p2p.h)

PeerGroupDeleteRecord 函数从对等组中删除记录。创建者以及管理角色中的任何其他成员可能会删除特定记录。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDeleteRecord(
  [in] HGROUP     hGroup,
  [in] const GUID *pRecordId
);

[in] hGroup

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

[in] pRecordId

指定唯一标识要删除的记录的 GUID 值。此参数是必需的。

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

返回代码	说明
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