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

Статья
03/01/2024

Функция PeerGroupDeleteRecord удаляет запись из одноранговой группы. Создатель, а также любой другой участник с административной ролью может удалить определенную запись.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupDeleteRecord(
  [in] HGROUP     hGroup,
  [in] const GUID *pRecordId
);

Параметры

[in] hGroup

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

[in] pRecordId

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

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

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

Код возврата	Описание
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

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

PeerGroupUpdateRecord

Share via