QueryContextAttributes (CredSSP) (fonction)
La fonction QueryContextAttributes (CredSSP) permet à une application de transport d’interroger le package de sécurité du fournisseur de support de sécurité des informations d’identification (CredSSP) pour certains attributs d’un contexte de sécurité.
Syntaxe
SECURITY_STATUS SEC_ENTRY QueryContextAttributes(
_In_ PCtxtHandle phContext,
_In_ ULONG ulAttribute,
_Out_ PVOID pBuffer
);
Paramètres
-
phContext [ dans]
-
Handle vers le contexte de sécurité à interroger.
-
ulAttribute [ dans]
-
Attribut du contexte à retourner. Ce paramètre peut prendre les valeurs suivantes. Sauf spécification contraire, les attributs sont applicables à la fois au client et au serveur.
Valeur Signification - SECPKG _ 0x80000012 _ _ _ jeton d’accès de l’attr C
Le paramètre pbuffer contient un pointeur vers une structure SecPkgContext _ AccessToken qui spécifie le jeton d’accès pour le contexte de sécurité actuel.
Cet attribut est pris en charge uniquement sur le serveur.- SECPKG _ ATTR _ C _ _ _ jeton d’accès complet
- 0x80000082
Le paramètre pbuffer contient un pointeur vers une structure SecPkgContext _ AccessToken qui spécifie le jeton d’accès pour le contexte de sécurité actuel.
Cet attribut est pris en charge uniquement sur le serveur.- SECPKG _ ATTR _ _ _ État de l’approbation du certificat
- 0x80000084
Le paramètre pbuffer contient un pointeur vers une structure d' _ _ État d’approbation de certificat qui spécifie des informations d’approbation sur le certificat.
Cet attribut est pris en charge uniquement sur le client.- SECPKG _ ATTR _ CREDS
- 0x80000080
Le paramètre pbuffer contient un pointeur vers une structure SecPkgContext _ ClientCreds qui spécifie les informations d’identification du client.
Les informations d’identification du client peuvent être un nom d’utilisateur et un mot de passe ou un nom d’utilisateur et un code confidentiel de carte à puce.
Cet attribut est pris en charge uniquement sur le serveur.- SECPKG _ _Références d’identification _ 2
- 0x80000086
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 de _ _ connexion interactive KERB compressée.
Si les informations d’identification du client sont le nom d’utilisateur et le code confidentiel de la carte à puce, la mémoire tampon est une structure de _ _ connexion de certificat KERB compressée.
Si les informations d’identification du client sont des informations d’identification d’identité en ligne, la mémoire tampon est une structure EX2 de l' _ _ identité d’authentification _ _ winnt du sec 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.- SECPKG _ 0x80000081 _ de _ package de négociation attr
Le paramètre pbuffer contient un pointeur vers une structure SecPkgContext _ PackageInfo qui spécifie le nom du package d’authentification négocié par le fournisseur Microsoft Negotiate . - SECPKG _ _ _ Informations sur le package attr
- 10
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.- SECPKG _ _ _ _ Identificateurs d’authentification du serveur attr
- 0x80000083
Le paramètre pbuffer contient un pointeur vers une structure d' _ indicateurs SecPkgContext qui spécifie des informations sur les indicateurs dans le contexte de sécurité actuel.
Cet attribut est pris en charge uniquement sur le client.- SECPKG _ _Tailles d’attr
- 0x0
Le paramètre pbuffer contient un pointeur vers une structure de _ tailles SecPkgContext .
Interroge les tailles des structures utilisées dans les fonctions par message et les échanges d’authentification.- SECPKG _ _Attributs de _ sécurité _ de l’objet attr
- 124
Le paramètre pbuffer contient un pointeur vers une structure SecPkgContext _ SubjectAttributes .
Cette valeur renvoie 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. -
pbuffer [ à]
-
Pointeur vers une structure qui reçoit les attributs. Le type de structure dépend de la valeur du paramètre ulAttribute .
Valeur de retour
Si la fonction est réussie, elle retourne SEC _ E _ OK.
Si la fonction échoue, elle peut retourner les codes d’erreur suivants.
| Code/valeur de retour | Description |
|---|---|
|
Échec de la fonction. Le paramètre phContext spécifie un handle vers un contexte incomplet. |
|
Échec de la fonction. La valeur du paramètre ulAttribute n’est pas valide. |
Remarques
La structure vers laquelle pointe le paramètre pbuffer varie en fonction de l’attribut interrogé.
Alors que l’appelant doit allouer la structure pbuffer elle-même, le fournisseur de services partagés alloue la mémoire nécessaire pour contenir les membres de taille variable de la structure pbuffer . La mémoire allouée par le SSP doit être libérée par l’appel de la fonction FreeContextBuffer .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
| Noms Unicode et ANSI |
QueryContextAttributesW (Unicode) et QueryContextAttributesA (ANSI) |