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

Статья
08/25/2023

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphDeleteRecord(
  [in] HGRAPH     hGraph,
  [in] const GUID *pRecordId,
  [in] BOOL       fLocal
);

Параметры

[in] hGraph

Дескриптор однорангового графа.

[in] pRecordId

Указатель на удаляемую запись.

[in] fLocal

Укажите значение TRUE , чтобы удалить запись только из локальной базы данных без уведомления остальной части однорангового графа об изменении. Укажите ЗНАЧЕНИЕ FALSE, чтобы удалить запись из всего однорангового графа.

Примечание Если задать значение TRUE , запись не будет добавлена снова во время следующей синхронизации графа с соседом. Указание TRUE действует только в том случае, если PEER_SECURITY_INTERFACE указан в вызове PeerGraphOpen или PeerGraphCreate, и только если PEER_SECURITY_INTERFACE содержит PFNPEER_VALIDATE_RECORD функцию, которая возвращает PEER_E_INVALID_RECORD при проверке записи.

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

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

Код возврата	Описание
E_ACCESSDENIED	Не удается получить доступ к одноранговой диаграмме.
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

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

PeerGraphAddRecord

PeerGraphEnumRecords

PeerGraphGetRecord

PeerGraphUpdateRecord

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