structure PEER_SECURITY_INTERFACE (p2p.h)
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 |