structure PEER_SECURITY_INTERFACE (p2p.h)

  • Article

La structure PEER_SECURITY_INTERFACE spécifie les interfaces de sécurité que les API Peer Graphing utilisent pour valider, sécuriser et libérer les enregistrements. En outre, il permet à une application de spécifier le chemin d’accès au .DLL qui contient une implémentation d’un fournisseur de services de sécurité (SSP).

Syntaxe

typedef struct peer_security_interface_tag {
  DWORD                           dwSize;
  PWSTR                           pwzSspFilename;
  PWSTR                           pwzPackageName;
  ULONG                           cbSecurityInfo;
  PBYTE                           pbSecurityInfo;
  PVOID                           pvContext;
  PFNPEER_VALIDATE_RECORD         pfnValidateRecord;
  PFNPEER_SECURE_RECORD           pfnSecureRecord;
  PFNPEER_FREE_SECURITY_DATA      pfnFreeSecurityData;
  PFNPEER_ON_PASSWORD_AUTH_FAILED pfnAuthFailed;
} PEER_SECURITY_INTERFACE, *PPEER_SECURITY_INTERFACE;

Membres

dwSize

Spécifie la taille de la structure. Définissez la valeur sizeof(PEER_SECURITY_INTERFACE). Ce membre est obligatoire et n’a aucune valeur par défaut.

pwzSspFilename

Spécifie le chemin d’accès complet et le nom de fichier d’un .DLL qui implémente l’interface SSP. Pour plus d’informations sur l’interface SSP, consultez la documentation SSPI .

pwzPackageName

Spécifie l’ID du module de sécurité dans le fournisseur de services partagés à utiliser.

cbSecurityInfo

Spécifie le nombre d’octets du membre pbSecurityInfo . Ce membre n’est pas obligatoire si pbSecurityInfo a la valeur NULL. Toutefois, si pbSecurityInfo n’a pas la valeur NULL, ce membre doit avoir une valeur.

pbSecurityInfo

Pointeur vers une mémoire tampon qui contient les informations utilisées pour créer ou ouvrir un graphe d’homologue. Ce membre est facultatif et peut avoir la valeur NULL.

L’objet blob de données de sécurité pointé vers pbSecurityInfo est copié, puis transmis à l’appel de fonction SSPI de AcquireCredentialsHandle.

pvContext

Pointeur vers le contexte de sécurité. Ce contexte de sécurité est ensuite passé comme premier paramètre à PFNPEER_VALIDATE_RECORD, PFNPEER_FREE_SECURITY_DATA et PFNPEER_SECURE_RECORD. Ce membre est facultatif et peut avoir la valeur NULL.

pfnValidateRecord

Pointeur vers une fonction de rappel appelée lorsqu’un enregistrement nécessite une validation. Ce membre est facultatif et peut avoir la valeur NULL. Si pfnSecureRecord a la valeur NULL, ce membre doit également avoir la valeur NULL.

pfnSecureRecord

Pointeur vers une fonction de rappel appelée lorsqu’un enregistrement doit être sécurisé. Ce membre est facultatif et peut avoir la valeur NULL. Si pfnValidateRecord a la valeur NULL, ce membre doit également avoir la valeur NULL.

pfnFreeSecurityData

Pointeur vers une fonction de rappel utilisée pour libérer toutes les données allouées par le rappel pointé par pfnSecureRecord. Ce membre est facultatif et peut avoir la valeur NULL.

pfnAuthFailed

Remarques

Si vous avez développé votre propre fournisseur de services partagés, votre application ne doit pas appeler l’API Peer Graphing pour accéder aux données de la base de données de graphique ; cela peut entraîner une situation d’interblocage. Au lieu de cela, l’application doit examiner une copie mise en cache des informations.

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
En-tête p2p.h

Voir aussi

AcquireCredentialsHandle

PFNPEER_FREE_SECURITY_DATA

PFNPEER_SECURE_RECORD

PFNPEER_VALIDATE_RECORD

PeerGraphCreate

PeerGraphOpen