PFNPEER_VALIDATE_RECORD fonction de rappel (p2p.h)

Article
03/04/2024

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

Syntaxe

PFNPEER_VALIDATE_RECORD PfnpeerValidateRecord;

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

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 doit pointer vers le membre pvContext de la structure PEER_SECURITY_INTERFACE .

[in] pRecord

Spécifie l’enregistrement à valider.

[in] changeType

Spécifie la raison pour laquelle la validation doit se produire. Doit être l’une des valeurs PEER_RECORD_CHANGE_TYPE .

Valeur retournée

Si ce rappel réussit, la valeur de retour est S_OK ; sinon, la fonction retourne l’une des erreurs suivantes :

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
PEER_E_DEFERRED_VALIDATION	L’enregistrement spécifié ne peut pas être validé pour le moment, car les informations ne sont pas suffisantes pour terminer l’opération. La validation est différée. Appelez PeerGraphValidateDeferredRecords lorsque des informations suffisantes sont obtenues .
PEER_E_INVALID_RECORD	L’enregistrement spécifié n’est pas valide.

Remarques

Lorsque ce rappel est appelé par l’infrastructure de graphes d’homologue, une valeur PEER_RECORD_CHANGE_TYPE est passée. Cela spécifie l’opération qui vient d’être effectuée sur l’enregistrement. L’application doit vérifier l’enregistrement en fonction du type de modification. Si l’application a besoin de plus d’informations pour vérifier l’enregistrement, elle peut retourner PEER_E_DEFERRED_VALIDATION et l’infrastructure de graphes homologue place l’enregistrement dans une liste d’enregistrements différés. Une fois que le mécanisme de sécurité dispose d’informations suffisantes pour valider l’enregistrement, il appelle PeerGraphValidateDeferredRecords, et tout enregistrement de la liste d’enregistrements différés est soumis à nouveau pour validation.

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_RECORD

PEER_RECORD_CHANGE_TYPE

PEER_SECURITY_INTERFACE

PeerGraphValidateDeferredRecords