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

  • Статья

Функция PeerGraphGetRecord извлекает определенную запись на основе указанного идентификатора записи. Возвращаемая запись должна быть освобождена путем вызова PeerGraphFreeData.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetRecord(
  [in]  HGRAPH       hGraph,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Параметры

[in] hGraph

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

[in] pRecordId

Указатель на извлекаемую запись.

[out] ppRecord

Получает запрошенную запись. Если эта структура больше не требуется, освободите ее, вызвав PeerGraphFreeData.

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

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

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

Требования

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

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

PEER_RECORD

PeerGraphFreeData