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

Функция PeerGraphEnumRecords (p2p.h)

  • Статья

Функция PeerGraphEnumRecords создает и возвращает дескриптор перечисления, используемый для перечисления записей определенного типа записи, пользователя или и того, и другого. Перечисление предоставляет snapshot записей во время выполнения перечисления.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
  [in]  HGRAPH     hGraph,
  [in]  const GUID *pRecordType,
  [in]  PCWSTR     pwzPeerId,
  [out] HPEERENUM  *phPeerEnum
);

Параметры

[in] hGraph

Дескриптор однорангового графа.

[in] pRecordType

Указатель на тип записей для перечисления. Укажите значение NULL для перечисления всех типов записей.

[in] pwzPeerId

Указатель на строку, идентифицирующая создателя, для которому приложение запрашивает перечисление. Укажите значение NULL для перечисления всех записей.

[out] phPeerEnum

Получает дескриптор перечисления. Укажите дескриптор для всех вызовов PeerGraphGetNextItem. Если дескриптор не требуется, освободите его, вызвав PeerGraphEndEnumeration.

Возвращаемое значение

Если вызов функции выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращается одно из следующих значений.

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

Комментарии

  • Если параметры pRecordType и pwzPeerId имеют значение NULL, возвращаются все записи.
  • Для простых задач перечисления используйте функцию PeerGraphEnumRecords , так как она более эффективна, чем функция PeerGraphSearchRecords . Для сложных задач перечисления и фильтрации, таких как эвристические поиски в базе данных, используйте функцию PeerGraphSearchRecords .

Требования

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

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

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords