SetContextAttributesA, fonction (sspi.h)

Permet à une application de transport de définir les attributs d’un contexte de sécurité pour un package de sécurité. Cette fonction est prise en charge uniquement par le package de sécurité Schannel.

Syntaxe

SECURITY_STATUS SEC_ENTRY SetContextAttributesA(
  [in] PCtxtHandle   phContext,
  [in] unsigned long ulAttribute,
  [in] void          *pBuffer,
  [in] unsigned long cbBuffer
);

Paramètres

[in] phContext

Handle du contexte de sécurité à définir.

[in] ulAttribute

Attribut du contexte à définir. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
SECPKG_ATTR_APP_DATA
94
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_SessionAppData .

Définit les données d’application pour la session.

Cet attribut est pris en charge uniquement par le package de sécurité Schannel.

SECPKG_ATTR_EAP_PRF_INFO
101
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_EapPrfInfo .

Définit la fonction pseudo-aléatoire (PRF) utilisée par le protocole EAP (Extensible Authentication Protocol). Il s’agit de la valeur retournée par un appel à la fonction QueryContextAttributes (Schannel) quand SECPKG_ATTR_EAP_KEY_BLOCK est passé en tant que valeur du paramètre ulAttribute .

Cet attribut est pris en charge uniquement par le package de sécurité Schannel.

SECPKG_ATTR_EARLY_START
105
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_EarlyStart .

Définit la fonctionnalité False Start. Pour plus d’informations sur cette fonctionnalité, consultez le billet de blog Création d’un site web plus rapide et plus sécurisé .

SECPKG_ATTR_DTLS_MTU
34
Définit et récupère la valeur MTU (unité de transmission maximale) à utiliser avec DTLS. Si DTLS n’est pas activé dans un contexte de sécurité, cet attribut n’est pas pris en charge.

Les valeurs valides sont comprises entre 200 octets et 64 kilo-octets. La valeur MTU DTLS par défaut dans Schannel est de 1 096 octets.

SECPKG_ATTR_KEYING_MATERIAL_INFO
106
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_KeyingMaterialInfo . La fonctionnalité d’exportation de matériel de clé suit la norme RFC 5705.

Cet attribut est pris en charge uniquement par le package de sécurité Schannel dans Windows 10 et Windows Server 2016 ou versions ultérieures.

[in] pBuffer

Pointeur vers une structure qui contient des valeurs à définir pour les attributs. Le type de structure pointée vers dépend de la valeur spécifiée dans le paramètre ulAttribute .

[in] cbBuffer

Taille, en octets, du paramètre pBuffer .

Valeur retournée

Si la fonction réussit, la fonction retourne SEC_E_OK.

Si la fonction échoue, elle retourne un code d’erreur différent de zéro. Le code d’erreur suivant est l’un des codes d’erreur possibles.

Code de retour Description
SEC_E_UNSUPPORTED_FUNCTION
Cette valeur est retournée par le mode noyau Schannel pour indiquer que cette fonction n’est pas prise en charge.

Remarques

Notes

L’en-tête sspi.h définit SetContextAttributes 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. La combinaison 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.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête sspi.h (include Security.h)
Bibliothèque Secur32.lib
DLL Secur32.dll