通过

PeerGraphDeleteRecord 函数 (p2p.h)

  • 项目

PeerGraphDeleteRecord 函数在对等图中将记录标记为已删除。 记录在函数调用的本地节点上不可用，例如，对 PeerGraphGetRecord 和 PeerGraphEnumRecords 的调用。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphDeleteRecord(
  [in] HGRAPH     hGraph,
  [in] const GUID *pRecordId,
  [in] BOOL       fLocal
);

参数

[in] hGraph

对等图的句柄。

[in] pRecordId

指向要删除的记录 ID 的指针。

[in] fLocal

指定 TRUE 可仅从本地数据库删除记录，而不通知对等图的其余部分有关更改。 指定 FALSE 以从整个对等图中删除记录。

注意 指定 TRUE 不会阻止在与邻居进行下一个图形同步期间再次添加记录。 仅当在对 PeerGraphOpen 或 PeerGraphCreate 的调用中指定PEER_SECURITY_INTERFACE，并且仅当 PEER_SECURITY_INTERFACE 包含一个在验证记录时返回PEER_E_INVALID_RECORD的PFNPEER_VALIDATE_RECORD函数时，指定 TRUE 才有效。
 

返回值

如果函数调用成功，则返回值 S_OK。 否则，它将返回以下值之一。

返回代码 说明
E_ACCESSDENIED
 无法访问对等图。
PEER_E_GRAPH_NOT_READY
 对等图未同步。 在关系图同步之前，无法删除记录。
PEER_E_INVALID_GRAPH
 对等图的句柄无效。
PEER_E_NOT_INITIALIZED
 必须先通过调用 PeerGraphStartup 初始化对等图，然后才能使用此函数。
PEER_E_RECORD_NOT_FOUND
 找不到指定的记录。

要求

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

另请参阅

PeerGraphAddRecord

PeerGraphEnumRecords

PeerGraphGetRecord

PeerGraphUpdateRecord