PFNPEER_SECURE_RECORD fonction de rappel (p2p.h)

Article
03/01/2024

Le rappel PFNPEER_SECURE_RECORD spécifie la fonction que l’infrastructure de graphes d’homologue appelle pour sécuriser les enregistrements.

Syntaxe

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

Paramètres

[in] hGraph

Spécifie le graphe d’homologue associé à l’enregistrement spécifié.

[in] pvContext

Pointeur vers le contexte de sécurité. Ce paramètre pointe vers le membre pvContext de la structure PEER_SECURITY_INTERFACE .

[in] pRecord

Pointeur vers l’enregistrement à sécuriser.

[in] changeType

Spécifie la raison pour laquelle la validation doit se produire. PEER_RECORD_CHANGE_TYPE énumère les valeurs valides.

[out] ppSecurityData

Spécifie les données de sécurité pour cet enregistrement. Ces données sont libérées en appelant la méthode spécifiée dans le membre pfnFreeSecurityData du PEER_SECURITY_INTERFACE après que les données ont été copiées et ajoutées à l’enregistrement.

Valeur retournée

Si ce rappel réussit, la valeur de retour est S_OK.

Remarques

Ce rappel est appelé chaque fois qu’une application appelle l’une des méthodes qui modifient les enregistrements, telles que PeerGraphAddRecord ou PeerGraphUpdateRecord. Ce rappel
doit créer des données spécifiques à cet enregistrement, telles qu’une petite signature numérique, et les retourner via le paramètre ppSecurityData . Ces données sont ensuite ajoutées à l’enregistrement dans le membre securityData et sont vérifiées par la méthode spécifiée par le membre pfnValidateRecord du PEER_SECURITY_INTERFACE.

Note Ce processus se produit sur l’ordinateur local ainsi que sur n’importe quel homologue connecté au graphe lorsque l’homologue reçoit l’enregistrement.

Si l’opération spécifiée par le paramètre changeType n’est pas autorisée, le rappel doit retourner un code d’échec, tel que PEER_E_NOT_AUTHORIZED, au lieu de S_OK.

Ce rappel peut être appelé à partir de n’importe quelle fonction de l’API Peer Graphing impliquant des enregistrements, comme PeerGraphUpdateRecord.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h

Voir aussi

PEER_DATA

PEER_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

Partager via