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

Статья
03/01/2024

Функция PeerGroupAddRecord добавляет новую запись в группу одноранговых узлов, которая распространяется на все участвующие одноранговые узлы.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

Параметры

[in] hGroup

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

[in] pRecord

Указатель на структуру PEER_RECORD , добавляемую в одноранговую группу, указанную в hGroup. Это обязательный параметр.

В PEER_RECORD должны быть заполнены следующие элементы.

dwSize
type
ftExpiration

ftExpiration должно быть выражено как одноранговое время (см. Раздел PeerGroupUniversalTimeToPeerTime).

Следующие элементы игнорируются и перезаписываются при их заполнении.

идентификатор
pwzCreatorId
pwzLastModifiedById
ftCreation
ftLastModified
securityData

Остальные поля являются необязательными.

[out] pRecordId

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

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

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

Код возврата	Описание
E_INVALIDARG	Один из параметров недопустим.
E_OUTOFMEMORY	Недостаточно памяти для выполнения указанной операции.
PEER_E_GROUP_NOT_READY	Одноранговая группа не находится в состоянии, в котором можно добавить записи. Например, вызывается PeerGroupJoin , но синхронизация с базой данных одноранговой группы не завершена.
PEER_E_INVALID_ATTRIBUTES	XML-строка, содержащая атрибуты записи в элементе pwzAttributes структуры PEER_RECORD , не соответствует спецификации схемы.
PEER_E_INVALID_GROUP	Дескриптор группы одноранговых узлов недопустим.
PEER_E_INVALID_PEER_NAME	Указано недопустимое имя однорангового узла.
PEER_E_INVALID_RECORD	Одно или несколько полей в PEER_RECORD недопустимы.
PEER_E_MAX_RECORD_SIZE_EXCEEDED	Размер записи превысил максимальный размер, разрешенный свойствами группы одноранговых узлов.
PEER_E_NOT_AUTHORIZED	Удостоверение не авторизовано для публикации записи этого типа.

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

Требования

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

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

PEER_RECORD

PeerGroupDeleteRecord

PeerGroupEnumRecords

PeerGroupUpdateRecord

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