HTTP_AUTH_STATUS-Enumeration (http.h)

  • Artikel

Die HTTP_AUTH_STATUS-Enumeration definiert den Authentifizierungsstatus einer Anforderung.

Diese Enumeration wird in der HTTP_REQUEST_AUTH_INFO-Struktur verwendet.

Syntax

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

Konstanten

 
HttpAuthStatusSuccess
Die Anforderung wurde erfolgreich für den in der HTTP_REQUEST_AUTH_INFO-Struktur angegebenen Authentifizierungstyp authentifiziert.
HttpAuthStatusNotAuthenticated
Die Authentifizierung wurde für die URL-Gruppe für diese Anforderung konfiguriert, die HTTP-Server-API hat die Authentifizierung jedoch nicht verarbeitet. Dies kann auf einen der folgenden Gründe zurückzuführen sein:


  • Das im HttpHeaderAuthorization-Header der Anforderung definierte Schema wird von der HTTP-Server-API nicht unterstützt oder für die URL-Gruppe nicht aktiviert. Wenn das Schema nicht aktiviert ist, wird das AuthType-Element von HTTP_REQUEST_AUTH_INFO auf den entsprechenden Typ festgelegt, andernfalls weist AuthType den Wert HttpRequestAuthTypeNone auf.

  • Der Autorisierungsheader ist nicht vorhanden, die Authentifizierung ist jedoch für die URL-Gruppe aktiviert.


Die Anwendung sollte entweder mit ihrer eigenen Authentifizierung fortfahren oder mit der anfänglichen 401-Challenge antworten, die den gewünschten Satz von Authentifizierungsschemas enthält.
HttpAuthStatusFailure
Fehler bei der Authentifizierung für den in der HTTP_REQUEST_AUTH_INFO-Struktur aufgeführten Authentifizierungstyp, möglicherweise aus einem der folgenden Gründe:

  • Das SSPI-basierte Authentifizierungsschema (Security Service Provider Interface) konnte von einem Aufruf von AcceptSecurityContext nicht erfolgreich zurückgegeben werden. Der zurückgegebene Fehler AcceptSecurityContext wird im SecStatus-Element der HTTP_REQUEST_AUTH_INFO-Struktur angezeigt.

  • Der fertige Clientkontext gilt für eine NTLM-Sitzung mit Null. NULL-Sitzungen werden als Authentifizierungsfehler behandelt.

  • Fehler beim Aufruf von LogonUser für die Standardauthentifizierung.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile http.h

Weitere Informationen

HTTP-Server-API Version 2.0-Enumerationstypen

HTTP_REQUEST_AUTH_INFO