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

функция обратного вызова PFNPEER_VALIDATE_RECORD (p2p.h)

  • Статья

Обратный вызов PFNPEER_VALIDATE_RECORD указывает функцию, которую инфраструктура однорангового графирования вызывает для проверки записей.

Синтаксис

PFNPEER_VALIDATE_RECORD PfnpeerValidateRecord;

HRESULT PfnpeerValidateRecord(
  [in] HGRAPH hGraph,
  [in] PVOID pvContext,
  [in] PPEER_RECORD pRecord,
  [in] PEER_RECORD_CHANGE_TYPE changeType
)
{...}

Параметры

[in] hGraph

Указывает одноранговый граф, связанный с указанной записью.

[in] pvContext

Указатель на контекст безопасности. Этот параметр должен указывать на элемент pvContextструктуры PEER_SECURITY_INTERFACE .

[in] pRecord

Указывает запись для проверки.

[in] changeType

Указывает причину, по которой должна выполняться проверка. Должно быть одним из PEER_RECORD_CHANGE_TYPE значений.

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

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

Код возврата Описание
E_INVALIDARG
 Один из параметров недопустим.
PEER_E_DEFERRED_VALIDATION
 В настоящее время не удается проверить указанную запись, так как для завершения операции недостаточно сведений. Проверка откладывается. Вызовите PeerGraphValidateDeferredRecords при получении достаточной информации.
PEER_E_INVALID_RECORD
 Указанная запись недопустимая.

Комментарии

Когда этот обратный вызов вызывается инфраструктурой однорангового графирования, передается значение PEER_RECORD_CHANGE_TYPE . Это указывает операцию, только что выполненную с записью. Приложение должно проверить запись на основе типа изменения. Если приложению требуются дополнительные сведения для проверки записи, оно может вернуть PEER_E_DEFERRED_VALIDATION и инфраструктура однорангового графирования помещает запись в список отложенных записей. Когда механизм безопасности получает достаточно информации для проверки записи, он вызывает PeerGraphValidateDeferredRecords, и все записи в списке отложенных записей повторно передаются на проверку.

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

Требования

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

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

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

PeerGraphValidateDeferredRecords