structure SecPkgContext_KeyInfoW (sspi.h)

Article
11/20/2024

La structure SecPkgContext_KeyInfo contient des informations sur les clés de session utilisées dans un contexte de sécurité . La fonction QueryContextAttributes (Général) utilise cette structure.

Les applications utilisant le fournisseur de support de sécurité Schannel (SSP) ne doivent pas utiliser la structure SecPkgContext_KeyInfo. Utilisez plutôt la structure SecPkgContext_ConnectionInfo.

Syntaxe

typedef struct _SecPkgContext_KeyInfoW {
  SEC_WCHAR     *sSignatureAlgorithmName;
  SEC_WCHAR     *sEncryptAlgorithmName;
  unsigned long KeySize;
  unsigned long SignatureAlgorithm;
  unsigned long EncryptAlgorithm;
} SecPkgContext_KeyInfoW, *PSecPkgContext_KeyInfoW;

Membres

sSignatureAlgorithmName

Pointeur vers une chaîne terminée par null qui contient le nom, le cas échéant, de l’algorithme utilisé pour générer des signatures, par exemple « MD5 » ou « SHA-2 ».

sEncryptAlgorithmName

Pointeur vers une chaîne terminée par null qui contient le nom, le cas échéant, de l’algorithme utilisé pour chiffrer les messages. Réservé pour une utilisation ultérieure.

KeySize

Spécifie la longueur de clé effective, en bits, pour la clé de session. Il s’agit généralement de 40, 56 ou 128 bits.

SignatureAlgorithm

Spécifie l’identificateur d’algorithme (ALG_ID) utilisé pour générer des signatures, le cas échéant.

EncryptAlgorithm

Spécifie l’identificateur d’algorithme (ALG_ID) utilisé pour chiffrer les messages. Réservé pour une utilisation ultérieure.

Remarques

Note

L’en-tête sspi.h définit SecPkgContext_KeyInfo en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
d’en-tête	sspi.h (include Security.h)

Voir aussi

QueryContextAttributes (Général)

Partager via