通过

PFNPEER_SECURE_RECORD回调函数 (p2p.h)

  • 项目

PFNPEER_SECURE_RECORD回调指定对等图形基础结构为保护记录而调用的函数。

语法

PFNPEER_SECURE_RECORD PfnpeerSecureRecord;

HRESULT PfnpeerSecureRecord(
  [in]  HGRAPH hGraph,
  [in]  PVOID pvContext,
  [in]  PPEER_RECORD pRecord,
  [in]  PEER_RECORD_CHANGE_TYPE changeType,
  [out] PPEER_DATA *ppSecurityData
)
{...}

参数

[in] hGraph

指定与指定记录关联的对等图。

[in] pvContext

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

[in] pRecord

指向要保护的记录的指针。

[in] changeType

指定必须进行验证的原因。 PEER_RECORD_CHANGE_TYPE 枚举有效值。

[out] ppSecurityData

指定此记录的安全数据。 复制数据并将其添加到记录后，通过调用 PEER_SECURITY_INTERFACE的 pfnFreeSecurityData 成员中指定的方法释放此数据。

返回值

如果此回调成功，则返回值S_OK。

注解

每当应用程序调用任何修改记录的方法（例如 PeerGraphAddRecord 或 PeerGraphUpdateRecord）时，将调用此回调。 此回调
应创建特定于此记录的数据（例如小型数字签名），并通过 ppSecurityData 参数返回它。 然后，此数据将添加到 securityData 成员中的记录，并由PEER_SECURITY_INTERFACE的 pfnValidateRecord 成员指定的方法进行验证。

注意 当对等方收到记录时，本地计算机以及连接到图形的任何对等方都会发生此过程。
 
如果不允许 changeType 参数指定的操作，则回调应返回失败代码（例如PEER_E_NOT_AUTHORIZED），而不是S_OK。

可以从任何涉及记录的对等图形 API 函数（例如 PeerGraphUpdateRecord）调用此回调。

要求

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

另请参阅

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE