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 |
|---|---|
|
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. |
|
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. |
|
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é . |
|
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. |
|
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 |
|---|---|
|
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 |