Share via

PFNPEER_SECURE_RECORD función de devolución de llamada (p2p.h)

  • Artículo

La PFNPEER_SECURE_RECORD devolución de llamada especifica la función a la que llama la infraestructura de grafos del mismo nivel para proteger los registros.

Sintaxis

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
)
{...}

Parámetros

[in] hGraph

Especifica el gráfico del mismo nivel asociado al registro especificado.

[in] pvContext

Puntero al contexto de seguridad. Este parámetro apunta al miembro pvContext de la estructura PEER_SECURITY_INTERFACE .

[in] pRecord

Puntero al registro que se va a proteger.

[in] changeType

Especifica el motivo por el que debe producirse la validación. PEER_RECORD_CHANGE_TYPE enumera los valores válidos.

[out] ppSecurityData

Especifica los datos de seguridad de este registro. Estos datos se liberan llamando al método especificado en el miembro pfnFreeSecurityData del PEER_SECURITY_INTERFACE después de copiar los datos y agregarlos al registro.

Valor devuelto

Si esta devolución de llamada se realiza correctamente, se S_OK el valor devuelto.

Comentarios

Esta devolución de llamada se invoca cada vez que una aplicación llama a cualquiera de los métodos que modifican registros, como PeerGraphAddRecord o PeerGraphUpdateRecord. Esta devolución de llamada
debe crear datos específicos de este registro, como una pequeña firma digital, y devolverlos a través del parámetro ppSecurityData . A continuación, estos datos se agregan al registro en el miembro securityData y el método especificado por el miembro pfnValidateRecord del PEER_SECURITY_INTERFACE.

Nota Este proceso se produce en el equipo local, así como en cualquier elemento del mismo nivel conectado al gráfico cuando el elemento del mismo nivel recibe el registro.
 
Si no se permite la operación especificada por el parámetro changeType , la devolución de llamada debe devolver un código de error, como PEER_E_NOT_AUTHORIZED, en lugar de S_OK.

Esta devolución de llamada se puede invocar desde cualquiera de las funciones de Peer Graphing API que implican registros, como PeerGraphUpdateRecord.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible No se admite ninguno
Plataforma de destino Windows
Encabezado p2p.h

Consulte también

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE