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

指向安全上下文的指针。 此参数应指向 PEER_SECURITY_INTERFACE 结构的 pvContext 成员。

[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)调用此回调。

要求

要求
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h

另请参阅

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

PeerGraphValidateDeferredRecords