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

O retorno de chamada PFNPEER_VALIDATE_RECORD especifica a função que a Infraestrutura de Grafo par chama para validar registros.

Sintaxe

PFNPEER_VALIDATE_RECORD PfnpeerValidateRecord;

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

Parâmetros

[in] hGraph

Especifica o grafo par associado ao registro especificado.

[in] pvContext

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

[in] pRecord

Especifica o registro a ser validado.

[in] changeType

Especifica o motivo pelo qual a validação deve ocorrer. Deve ser um dos valores PEER_RECORD_CHANGE_TYPE .

Retornar valor

Se esse retorno de chamada for bem-sucedido, o valor retornado será S_OK; caso contrário, a função retornará um dos seguintes erros:

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
PEER_E_DEFERRED_VALIDATION	O registro especificado não pode ser validado no momento porque não há informações suficientes para concluir a operação. A validação é adiada. Chame PeerGraphValidateDeferredRecords quando informações suficientes forem obtidas .
PEER_E_INVALID_RECORD	O registro especificado é inválido.

Comentários

Quando esse retorno de chamada é chamado pela Infraestrutura de Grafo par, um valor PEER_RECORD_CHANGE_TYPE é passado. Isso especifica a operação executada no registro. O aplicativo deve verificar o registro com base no tipo de alteração. Se o aplicativo exigir mais informações para verificar o registro, ele poderá retornar PEER_E_DEFERRED_VALIDATION e a Infraestrutura de Grafo par colocará o registro em uma lista de registros adiados. Depois que o mecanismo de segurança tiver informações suficientes para validar o registro, ele chamará PeerGraphValidateDeferredRecords e qualquer registro na lista de registros adiados será enviado novamente para validação.

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_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

PeerGraphValidateDeferredRecords