Поделиться через

Функция 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. В противном случае возвращается одно из следующих значений.

Код возврата Описание
E_INVALIDARG
 Один из параметров недопустим.
E_OUTOFMEMORY
 Недостаточно памяти для выполнения указанной операции.
PEER_E_INVALID_GRAPH
 Дескриптор однорангового графа недопустим.
PEER_E_INVALID_SEARCH
 Указанный запрос не соответствует схеме поиска. Дополнительные сведения см. в разделе Формат запроса поиска записей .
PEER_E_NOT_INITIALIZED
 Одноранговый граф необходимо инициализировать с помощью вызова PeerGraphStartup , прежде чем использовать эту функцию.

Комментарии

Функция PeerGraphEnumRecords более эффективна, чем функция PeerGraphSearchRecords .

При вызове PeerGraphGetNextItem с дескриптором, возвращенным PeerGraphSearchRecords, PeerGraphGetNextItem возвращает данные в структуре PEER_RECORD .

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2PGraph.lib
DLL P2PGraph.dll

См. также раздел

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphEnumRecords

PeerGraphGetItemCount

PeerGraphGetNextItem