PeerGroupSearchRecords 函数 (p2p.h)
PeerGroupSearchRecords 函数在本地对等组数据库中搜索与所提供的条件匹配的记录。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSearchRecords(
[in] HGROUP hGroup,
[in] PCWSTR pwzCriteria,
[out] HPEERENUM *phPeerEnum
);
parameters
[in] hGroup
搜索其本地数据库的对等组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。
[in] pwzCriteria
指向包含记录搜索查询的 Unicode XML 字符串的指针。 有关制定 XML 查询字符串以搜索对等组记录数据库的信息,请参阅 记录搜索查询格式 文档。 此参数是必需的。
[out] phPeerEnum
指向包含返回的记录列表的枚举的指针。 此句柄传递到
PeerGetNextItem 用于检索项目,其中每个项表示为 指向PEER_RECORD 结构的指针。 完成后,将调用 PeerEndEnumeration 以返回枚举使用的内存。 此参数是必需的。
返回值
如果操作成功,则返回 S_OK 。 否则,函数将返回以下值之一。
返回代码 | 说明 |
---|---|
|
其中一个参数无效。 |
|
没有足够的内存可用于完成操作。 |
|
XML 搜索查询不符合 搜索查询架构规范。 |
可以从 Microsoft RSA 基本提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀,并在 Winerror.h 中定义。
要求
最低受支持的客户端 | 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2P.lib |
DLL | P2P.dll |