SetContextAttributesA, fonction (sspi.h)

Article
08/26/2023

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

Partager via