HTTP_SERVER_AUTHENTICATION_INFO-Struktur (http.h)

Die HTTP_SERVER_AUTHENTICATION_INFO-Struktur wird verwendet, um die serverseitige Authentifizierung für eine URL-Gruppe oder Serversitzung zu aktivieren. Diese Struktur wird auch verwendet, um die vorhandenen Authentifizierungsschemas abzufragen, die für eine URL-Gruppe oder Serversitzung aktiviert sind.

Diese Struktur muss beim Festlegen oder Abfragen von HttpServerAuthenticationProperty für eine URL-Gruppe oder Serversitzung verwendet werden.

Syntax

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;

Members

Flags

Die HTTP_PROPERTY_FLAGS-Struktur , die angibt, ob die Eigenschaft vorhanden ist.

AuthSchemes

Die unterstützten Authentifizierungsschemas. Dies kann eine oder mehrere der folgenden Sein:

Authentifizierungsschema	Bedeutung
HTTP_AUTH_ENABLE_BASIC	Die Standardauthentifizierung ist aktiviert.
HTTP_AUTH_ENABLE_DIGEST	Die Digestauthentifizierung ist aktiviert.
HTTP_AUTH_ENABLE_NTLM	DIE NTLM-Authentifizierung ist aktiviert.
HTTP_AUTH_ENABLE_NEGOTIATE	Die Aushandlung der Authentifizierung ist aktiviert.
HTTP_AUTH_ENABLE_KERBEROS	Die Kerberos-Authentifizierung ist aktiviert.
HTTP_AUTH_ENABLE_ALL	Alle Authentifizierungstypen sind aktiviert.

ReceiveMutualAuth

Ein boolescher Wert, der bei True angibt, dass die Clientanwendung die Serveranmeldeinformationen für die gegenseitige Authentifizierung mit der authentifizierten Anforderung empfängt. False gibt an, dass die Clientanwendung die Anmeldeinformationen nicht empfängt.

Beachten Sie, dass diese Option für alle Anforderungen festgelegt ist, die von der zugeordneten Anforderungswarteschlange verarbeitet werden.

ReceiveContextHandle

Ein boolescher Wert, der bei True angibt, dass der fertige Clientkontext serialisiert und mit der Anforderung an die Anwendung übergeben wird. False gibt an, dass die Anwendung den Kontext nicht empfängt. Dieses Handle kann zum Abfragen von Kontextattributen verwendet werden.

DisableNTLMCredentialCaching

Ein boolescher Wert, der bei True angibt, dass die NTLM-Anmeldeinformationen nicht zwischengespeichert werden. Bei False wird das Standardverhalten beibehalten.

Standardmäßig speichert HTTP den Clientkontext für Keep Alive -Verbindungen (KA) für das NTLM-Schema zwischen, wenn die Anforderung nicht von einem Proxy stammt.

ExFlags

Optionale Authentifizierungsflags. Es kann sich um einen oder mehrere der folgenden möglichen Werte handeln:

Wert	Bedeutung
HTTP_AUTH_EX_FLAG_ENABLE_KERBEROS_CREDENTIAL_CACHING	Wenn festgelegt, werden die Anmeldeinformationen für die Kerberos-Authentifizierung zwischengespeichert. Kerberos- oder Negotiate-Authentifizierung muss von AuthSchemes aktiviert werden.
HTTP_AUTH_EX_FLAG_CAPTURE_CREDENTIAL	Falls festgelegt, erfasst die HTTP-Server-API die Anmeldeinformationen des Aufrufers und verwendet sie für die Kerberos- oder Negotiate-Authentifizierung. Kerberos- oder Negotiate-Authentifizierung muss von AuthSchemes aktiviert werden.

DigestParams

Die HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS Struktur, die die Domäne und den Bereich für die Digest-Herausforderung bereitstellt.

BasicParams

Die HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS Struktur, die den Bereich für die grundlegende Herausforderung bereitstellt.

Hinweise

Die HTTP_SERVER_AUTHENTICATION_INFO-Struktur ist in der HTTP-Anforderung enthalten, wenn die Authentifizierung für die zugeordnete URL-Gruppe konfiguriert wurde. Der ursprüngliche HTTP-Authentifizierungsheader, der vom Client empfangen wurde, ist immer in der HTTP-Anforderung enthalten, unabhängig von der Authentifizierung status.

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

Strukturen der HTTP-Server-API, Version 2.0

HTTP_AUTH_ENABLE

HTTP_SERVER_PROPERTY

HttpQueryUrlGroupProperty

HttpSetUrlGroupProperty