peerGraphSearchRecords 函数 (p2p.h)
PeerGraphSearchRecords 函数在对等图中搜索特定记录。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSearchRecords(
[in] HGRAPH hGraph,
[in] PCWSTR pwzCriteria,
[out] HPEERENUM *phPeerEnum
);
参数
[in] hGraph
对等图的句柄。
[in] pwzCriteria
指向 XML 字符串的指针，该字符串指定要搜索的记录。 有关构建 XML 查询字符串以搜索对等图形记录的信息，请参阅 记录搜索查询格式。
[out] phPeerEnum
枚举的句柄。
返回值
如果函数调用成功，则返回值S_OK。 否则，它将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
其中一个参数无效。 |
|
内存不足，无法执行指定的操作。 |
|
对等图的句柄无效。 |
|
指定的查询不符合搜索架构。 有关详细信息 ，请参阅记录搜索查询格式 。 |
|
在使用此函数之前，必须通过调用 PeerGraphStartup 来初始化对等 图。 |
注解
PeerGraphEnumRecords 函数比 PeerGraphSearchRecords 函数更高效。
使用 PeerGraphSearchRecords 返回的句柄调用 PeerGraphGetNextItem 时，PeerGraphGetNextItem 返回PEER_RECORD结构中的数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包 |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2PGraph.lib |
| DLL | P2PGraph.dll |