Compartilhar via


PFNPEER_SECURE_RECORD função de retorno de chamada (p2p.h)

O retorno de chamada PFNPEER_SECURE_RECORD especifica a função que a Infraestrutura de Grafo de Pares chama para proteger registros.

Sintaxe

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 o grafo par associado ao registro especificado.

[in] pvContext

Ponteiro para o contexto de segurança. Esse parâmetro aponta para o membro pvContext da estrutura PEER_SECURITY_INTERFACE .

[in] pRecord

Ponteiro para o registro a ser seguro.

[in] changeType

Especifica o motivo pelo qual a validação deve ocorrer. PEER_RECORD_CHANGE_TYPE enumera os valores válidos.

[out] ppSecurityData

Especifica os dados de segurança para esse registro. Esses dados são liberados chamando o método especificado no membro pfnFreeSecurityData do PEER_SECURITY_INTERFACE depois que os dados são copiados e adicionados ao registro.

Retornar valor

Se esse retorno de chamada for bem-sucedido, o valor retornado será S_OK.

Comentários

Esse retorno de chamada é invocado sempre que um aplicativo chama qualquer um dos métodos que modificam registros, como PeerGraphAddRecord ou PeerGraphUpdateRecord. Esse retorno de chamada
deve criar dados específicos para esse registro, como uma assinatura digital pequena, e devolvê-los por meio do parâmetro ppSecurityData . Esses dados são adicionados ao registro no membro securityData e são verificados pelo método especificado pelo membro pfnValidateRecord do PEER_SECURITY_INTERFACE.

Nota Esse processo ocorre no computador local, bem como em qualquer par conectado ao grafo quando o par recebe o registro.
 
Se a operação especificada pelo parâmetro changeType não for permitida, o retorno de chamada deverá retornar um código de falha, como PEER_E_NOT_AUTHORIZED, em vez de S_OK.

Esse retorno de chamada pode ser invocado de qualquer uma das funções da API de Grafo par que envolvem registros, como PeerGraphUpdateRecord.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h

Confira também

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE