structure HTTP_SERVER_AUTHENTICATION_INFO (http.h)
La structure HTTP_SERVER_AUTHENTICATION_INFO est utilisée pour activer l’authentification côté serveur sur un groupe d’URL ou une session serveur. Cette structure est également utilisée pour interroger les schémas d’authentification existants activés pour un groupe d’URL ou une session serveur.
Cette structure doit être utilisée lors de la définition ou de l’interrogation de HttpServerAuthenticationProperty sur un groupe d’URL ou une session serveur.
Syntaxe
typedef struct _HTTP_SERVER_AUTHENTICATION_INFO {
HTTP_PROPERTY_FLAGS Flags;
ULONG AuthSchemes;
BOOLEAN ReceiveMutualAuth;
BOOLEAN ReceiveContextHandle;
BOOLEAN DisableNTLMCredentialCaching;
UCHAR ExFlags;
HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS DigestParams;
HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS BasicParams;
} HTTP_SERVER_AUTHENTICATION_INFO, *PHTTP_SERVER_AUTHENTICATION_INFO;
Membres
Flags
La structure HTTP_PROPERTY_FLAGS qui spécifie si la propriété est présente.
AuthSchemes
Schémas d’authentification pris en charge. Il peut s’agir de l’un ou plusieurs des éléments suivants :
ReceiveMutualAuth
Valeur booléenne qui indique, si true, que l’application cliente reçoit les informations d’identification du serveur pour l’authentification mutuelle avec la demande authentifiée. Si la valeur est False, l’application cliente ne reçoit pas les informations d’identification.
N’oubliez pas que cette option est définie pour toutes les requêtes traitées par la file d’attente de requêtes associée.
ReceiveContextHandle
Valeur booléenne qui indique, si true, que le contexte client finalisé est sérialisé et passé à l’application avec la demande. Si la valeur est False, l’application ne reçoit pas le contexte. Ce handle peut être utilisé pour interroger des attributs de contexte.
DisableNTLMCredentialCaching
Valeur booléenne qui indique, si true, que les informations d’identification NTLM ne sont pas mises en cache. Si la valeur est False, le comportement par défaut est conservé.
Par défaut, HTTP met en cache le contexte client pour les connexions Keep Alive (KA) pour le schéma NTLM si la demande ne provient pas d’un proxy.
ExFlags
Indicateurs d’authentification facultatifs. Il peut s’agir d’une ou plusieurs des valeurs possibles suivantes :
DigestParams
La structure HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS qui fournit le domaine et le domaine pour la tâche de synthèse.
BasicParams
La structure HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS qui fournit le domaine pour le défi de base.
Notes
La structure HTTP_SERVER_AUTHENTICATION_INFO est incluse dans la requête HTTP si l’authentification a été configurée sur le groupe d’URL associé. L’en-tête d’authentification HTTP d’origine reçu du client est toujours inclus dans la requête HTTP, quelle que soit la status d’authentification.
Spécifications
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| En-tête | http.h |