通过

PeerGraphGetRecord 函数 (p2p.h)

  • 项目

PeerGraphGetRecord 函数根据指定的记录 ID 检索特定记录。 应通过调用 PeerGraphFreeData 来释放返回的记录。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetRecord(
  [in]  HGRAPH       hGraph,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

参数

[in] hGraph

对等图的句柄。

[in] pRecordId

指向要检索的记录 ID 的指针。

[out] ppRecord

接收请求的记录。 如果不再需要此结构，请通过调用 PeerGraphFreeData 来释放它。

返回值

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

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
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

另请参阅

PEER_RECORD

PeerGraphFreeData