Функция PeerGroupSearchRecords (p2p.h)
Функция PeerGroupSearchRecords выполняет поиск записей, соответствующих заданным условиям, в локальной базе данных одноранговых групп.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSearchRecords(
[in] HGROUP hGroup,
[in] PCWSTR pwzCriteria,
[out] HPEERENUM *phPeerEnum
);
Параметры
[in] hGroup
Обработка одноранговой группы, в которой выполняется поиск в локальной базе данных. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.
[in] pwzCriteria
Указатель на xml-строку Юникода, содержащую запрос поиска записей. Сведения о создании строки XML-запроса для поиска в базе данных записей одноранговых групп см. в документации по формату запроса поиска записей . Это обязательный параметр.
[out] phPeerEnum
Указатель на перечисление, содержащее возвращенный список записей. Этот дескриптор передается в
PeerGetNextItem для получения элементов с каждым элементом, представленным в виде указателя на структуру PEER_RECORD . По завершении вызывается PeerEndEnumeration для возврата памяти, используемой перечислением. Это обязательный параметр.
Возвращаемое значение
Возвращает S_OK , если операция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Один из параметров недопустим. |
|
Недостаточно памяти для завершения операции. |
|
Поисковый запрос XML не соответствует спецификации схемы поискового запроса. |
Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.
Требования
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |