Partager via

énumération HTTP_AUTH_STATUS (http.h)

  • Article

L’énumération HTTP_AUTH_STATUS définit l’état d’authentification d’une demande.

Cette énumération est utilisée dans la structure HTTP_REQUEST_AUTH_INFO .

Syntax

typedef enum _HTTP_AUTH_STATUS {
  HttpAuthStatusSuccess,
  HttpAuthStatusNotAuthenticated,
  HttpAuthStatusFailure
} HTTP_AUTH_STATUS, *PHTTP_AUTH_STATUS;

Constantes

 
HttpAuthStatusSuccess
La demande a été authentifiée avec succès pour le type d’authentification indiqué dans la structure HTTP_REQUEST_AUTH_INFO .
HttpAuthStatusNotAuthenticated
L’authentification a été configurée sur le groupe d’URL pour cette requête, mais l’API serveur HTTP n’a pas géré l’authentification. Cela peut être dû à l’une des raisons suivantes :


  • Le schéma défini dans l’en-tête HttpHeaderAuthorization de la requête n’est pas pris en charge par l’API serveur HTTP ou n’est pas activé sur le groupe d’URL. Si le schéma n’est pas activé, le membre AuthType de HTTP_REQUEST_AUTH_INFO est défini sur le type approprié. Sinon , AuthType aura la valeur HttpRequestAuthTypeNone.

  • L’en-tête d’autorisation n’est pas présent, mais l’authentification est activée sur le groupe d’URL.


L’application doit procéder à sa propre authentification ou répondre avec le défi 401 initial contenant l’ensemble de schémas d’authentification souhaité.
HttpAuthStatusFailure
L’authentification pour le type d’authentification répertorié dans la structure HTTP_REQUEST_AUTH_INFO a échoué, peut-être pour l’une des raisons suivantes :

  • Le schéma d’authentification basé sur l’interface SSPI (Security Service Provider Interface) n’a pas réussi à revenir à partir d’un appel à AcceptSecurityContext. L’erreur retournée AcceptSecurityContext est indiquée dans le membre SecStatus de la structure HTTP_REQUEST_AUTH_INFO .

  • Le contexte client finalisé est destiné à une session NTLM Null. Les sessions Null sont traitées comme des échecs d’authentification.

  • L’appel à LogonUser a échoué pour l’authentification de base.

Configuration requise

   
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

Voir aussi

Types d’énumération de l’API serveur HTTP version 2.0

HTTP_REQUEST_AUTH_INFO