QueryContextAttributesExW, fonction (sspi.h)
Permet à une application de transport d’interroger un package de sécurité pour certains attributs d’un contexte de de sécurité.
Syntaxe
SECURITY_STATUS SEC_ENTRY QueryContextAttributesExW(
[in] PCtxtHandle phContext,
[in] unsigned long ulAttribute,
[out] void *pBuffer,
[in] unsigned long cbBuffer
);
Paramètres
[in] phContext
Handle vers le contexte de sécurité à interroger.
[in] ulAttribute
Spécifie l’attribut du contexte à renvoyer. Ce paramètre peut être l’une des valeurs suivantes.
| Valeur | Signification |
|---|---|
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_AccessToken.
Retourne un handle au jeton d’accès. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_SessionAppData.
Retourne ou spécifie 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_Authority.
Interroge le nom de l’autorité d’authentification. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_ClientSpecifiedTarget qui représente le nom de principal de service (SPN) de la cible initiale fournie par le client.
Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
|
Le paramètre pBuffer Retourne des informations détaillées sur la connexion établie. 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_ClientCreds qui spécifie les informations d’identification du client.
Si les informations d’identification du client sont le nom d’utilisateur et le mot de passe, la mémoire tampon est une structure KERB_INTERACTIVE_LOGON pack. Si les informations d’identification du client sont le nom d’utilisateur et le code confidentiel de carte à puce, la mémoire tampon est une structure KERB_CERTIFICATE_LOGON pack. Si les informations d’identification du client sont des informations d’identification d’identité en ligne, la mémoire tampon est une structure SEC_WINNT_AUTH_IDENTITY_EX2 marshalée. Cet attribut est pris en charge uniquement sur le serveur CredSSP. Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_DceInfo.
Requêtes pour les données d’autorisation utilisées par les services DCE. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_Bindings qui spécifie les informations de liaison de canal.
Cet attribut est pris en charge uniquement par le package de sécurité Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_EapKeyBlock.
Requêtes pour les données clés utilisées par le protocole TLS EAP. 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_Flags.
Retourne des informations sur les indicateurs de contexte négociés. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_IssuerListInfoEx.
Retourne la liste des émetteurs de certificat acceptés par le serveur. 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_KeyInfo.
Interroge des informations sur les clés utilisées dans un contexte de sécurité. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_LastClientTokenStatus qui spécifie si le jeton de l’appel le plus récent à la fonction InitializeSecurityContext est le dernier jeton du client.
Cette valeur est prise en charge uniquement par les packages de sécurité Negotiate, Kerberos et NTLM. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_Lifespan.
Interroge l’étendue de vie du contexte. |
|
Le paramètre pBuffer contient un pointeur vers une structure PCCERT_CONTEXT.
Recherche un contexte de certificat qui contient un certificat de fin local. Cet attribut est pris en charge uniquement par le package de sécurité Schannel. |
|
Le paramètre pBuffer Remplacé par SECPKG_ATTR_LOCAL_CERT_CONTEXT. |
|
Le paramètre pBuffer Interroge le nom associé au contexte. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_NativeNames.
Retourne le nom du principal (CNAME) à partir du ticket sortant. |
|
Le paramètre pBuffer Retourne des informations sur le package de sécurité à utiliser avec le processus de négociation et l’état actuel de la négociation pour l’utilisation de ce package. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_PackageInfo.
Retourne des informations sur le fournisseur de services partagés en cours d’utilisation. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_PasswordExpiry.
Retourne les informations d’expiration du mot de passe. |
|
Le paramètre pBuffer contient un pointeur vers une structure PCCERT_CONTEXT.
Recherche un contexte de certificat qui contient le certificat final fourni par le serveur. Cet attribut est pris en charge uniquement par le package de sécurité Schannel. |
|
Le paramètre pBuffer |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_SessionKey.
Retourne des informations sur les clés de session. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_SessionInfo.
Retourne des informations sur la session. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. 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_Sizes.
Interroge les tailles des structures utilisées dans les fonctions par message. |
|
Le paramètre pBuffer Interroge les tailles des différentes parties d’un flux utilisé dans les fonctions par message. 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_SubjectAttributes.
Cette valeur retourne des informations sur les attributs de sécurité de la connexion. Cette valeur est prise en charge uniquement sur le serveur CredSSP. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
|
Le paramètre pBuffer contient un pointeur vers une structure de SecPkgContext_SupportedSignatures.
Cette valeur retourne des informations sur les types de signature pris en charge pour la connexion. Cette valeur est prise en charge uniquement par le package de sécurité Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_TargetInformation.
Retourne des informations sur le nom du serveur distant. |
|
Le paramètre pBuffer contient un pointeur vers une structure SecPkgContext_Bindings qui spécifie les informations de liaison de canal.
Cette valeur est prise en charge uniquement par le package de sécurité Schannel. Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP : Cette valeur n’est pas prise en charge. |
[out] pBuffer
Pointeur vers une structure qui reçoit 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 valeur de retour est SEC_E_OK.
Si la fonction échoue, la valeur de retour est un code d’erreur différent de zéro.
Remarques
Note
L’en-tête sspi.h définit QueryContextAttributesEx 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 |