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

Статья
08/25/2023

Функция PeerGroupUpdateRecord обновляет запись в определенной одноранговой группе.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUpdateRecord(
  [in] HGROUP       hGroup,
  [in] PPEER_RECORD pRecord
);

Параметры

[in] hGroup

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

[in] pRecord

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

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

pwzAttributes
ftExpiration
data

Следующие элементы в PEER_RECORD должны присутствовать, но не могут быть изменены.

dwSize
идентификатор
type
dwFlags

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

DwVersion
pwzCreatorId
pwzModifiedById
ftCreation
ftLastModified
securityData

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

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

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

Код возврата	Описание
E_INVALIDARG	Один из указанных параметров недопустим.
PEER_E_GROUP_NOT_READY	Одноранговая группа не находится в состоянии, когда запись может быть обновлена, например, был вызван PeerGroupJoin , но синхронизация с базой данных одноранговой группы не завершена.
PEER_E_INVALID_GROUP	Дескриптор группы одноранговых узлов недопустим.
PEER_E_NOT_AUTHORIZED	У текущего однорангового удостоверения нет разрешения на удаление записи. В этом случае удостоверение однорангового узла не является создателем записи.
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