SetContextAttributesA, fonction (sspi.h)

Article
11/20/2024

Permet à une application de transport de définir des attributs d’un contexte de 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 être l’une des 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) lorsque SECPKG_ATTR_EAP_KEY_BLOCK est passé comme 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. Consultez le Création d’un billet de blog plus rapide et plus sécurisé sur le web pour plus d’informations sur cette fonctionnalité.
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 pour définir les attributs. Le type de structure pointé dépend de la valeur spécifiée dans le paramètre ulAttribute.

[in] cbBuffer

Taille, en octets, du paramètre pBuffer .

Valeur de retour

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.

Retourner le code	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

Note

L’en-tête sspi.h définit SetContextAttributes comme 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]
plateforme cible	Windows
d’en-tête	sspi.h (include Security.h)
bibliothèque	Secur32.lib
DLL	Secur32.dll

Partager via