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

Статья
08/25/2023

Функция PeerGroupGetRecord извлекает определенную запись группы.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetRecord(
  [in]  HGROUP       hGroup,
  [in]  const GUID   *pRecordId,
  [out] PPEER_RECORD *ppRecord
);

Параметры

[in] hGroup

Дескриптор для группы, содержащей определенную запись. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] pRecordId

Задает значение GUID, которое однозначно идентифицирует требуемую запись в одноранговой группе. Это обязательный параметр.

[out] ppRecord

Указатель на адрес структуры PEER_RECORD , содержащей возвращенную запись. Эта структура освобождается путем передачи указателя на PeerFreeData. Это обязательный параметр.

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

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

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.
PEER_E_GROUP_NOT_READY	Одноранговая группа не находится в состоянии, в котором можно получить записи группы. Например, вызывается PeerGroupJoin , но синхронизация с базой данных одноранговой группы не завершена.
PEER_E_INVALID_GROUP	Дескриптор группы одноранговых узлов недопустим.
PEER_E_RECORD_NOT_FOUND	Запись, соответствующую указанному идентификатору, не может быть найдена в одноранговой базе данных группы.

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Требования


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