PFNPEER_SECURE_RECORD funzione di callback (p2p.h)

Articolo
03/01/2024

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

Sintassi

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

Parametri

[in] hGraph

Specifica il grafico peer associato al record specificato.

[in] pvContext

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

[in] pRecord

Puntatore al record da proteggere.

[in] changeType

Specifica il motivo per cui deve verificarsi la convalida. PEER_RECORD_CHANGE_TYPE enumera i valori validi.

[out] ppSecurityData

Specifica i dati di sicurezza per questo record. Questi dati vengono rilasciati chiamando il metodo specificato nel membro pfnFreeSecurityData del PEER_SECURITY_INTERFACE dopo la copia dei dati e l'aggiunta al record.

Valore restituito

Se il callback ha esito positivo, il valore restituito è S_OK.

Commenti

Questo callback viene richiamato ogni volta che un'applicazione chiama uno dei metodi che modificano i record, ad esempio PeerGraphAddRecord o PeerGraphUpdateRecord. Questo callback
deve creare dati specifici per questo record, ad esempio una piccola firma digitale e restituirlo tramite il parametro ppSecurityData . Questi dati vengono quindi aggiunti al record nel membro securityData e vengono verificati dal metodo specificato dal membro pfnValidateRecord del PEER_SECURITY_INTERFACE.

Nota Questo processo si verifica nel computer locale e in qualsiasi peer connesso al grafico quando il peer riceve il record.

Se l'operazione specificata dal parametro changeType non è consentita, il callback deve restituire un codice di errore, ad esempio PEER_E_NOT_AUTHORIZED, anziché S_OK.

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_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

Condividi tramite