PFNPEER_VALIDATE_RECORD funzione di callback (p2p.h)

  • Articolo

Il callback PFNPEER_VALIDATE_RECORD specifica la funzione che l'infrastruttura peer graphing chiama per convalidare i record.

Sintassi

PFNPEER_VALIDATE_RECORD PfnpeerValidateRecord;

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

Parametri

[in] hGraph

Specifica il grafico peer associato al record specificato.

[in] pvContext

Puntatore al contesto di sicurezza. Questo parametro deve puntare al membro pvContext della struttura PEER_SECURITY_INTERFACE .

[in] pRecord

Specifica il record da convalidare.

[in] changeType

Specifica il motivo per cui deve verificarsi la convalida. Deve essere uno dei valori PEER_RECORD_CHANGE_TYPE .

Valore restituito

Se il callback ha esito positivo, il valore restituito è S_OK; in caso contrario, la funzione restituisce uno degli errori seguenti:

Codice restituito Descrizione
E_INVALIDARG
 Uno dei parametri non è valido.
PEER_E_DEFERRED_VALIDATION
 Impossibile convalidare il record specificato in questo momento perché non sono presenti informazioni sufficienti per completare l'operazione. La convalida viene posticipata. Chiamare PeerGraphValidateDeferredRecords quando vengono ottenute informazioni sufficienti.
PEER_E_INVALID_RECORD
 Il record specificato non è valido.

Commenti

Quando questo callback viene chiamato dall'infrastruttura peer graphing, viene passato un valore PEER_RECORD_CHANGE_TYPE . In questo modo viene specificata l'operazione appena eseguita nel record. L'applicazione deve verificare il record in base al tipo di modifica. Se l'applicazione richiede ulteriori informazioni per verificare il record, può restituire PEER_E_DEFERRED_VALIDATION e l'infrastruttura peer graphing inserisce il record in un elenco di record posticipati. Una volta che il meccanismo di sicurezza ha informazioni sufficienti per convalidare il record, chiama PeerGraphValidateDeferredRecords e qualsiasi record nell'elenco record posticipato viene nuovamente inviato per la convalida.

Questo callback può essere richiamato da una qualsiasi delle funzioni DELL'API Peer Graphing che coinvolgono record, ad esempio PeerGraphUpdateRecord.

Requisiti

Requisito Valore
Client minimo supportato Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione p2p.h

Vedi anche

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

PeerGraphValidateDeferredRecords