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

Статья
03/01/2024

Функция 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

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