HTTP_CHANNEL_BIND_INFO-Struktur (http.h)

  • Artikel

Die HTTP_CHANNEL_BIND_INFO-Struktur wird zum Festlegen oder Abfragen der Kanalbindungsauthentifizierung verwendet.

Syntax

typedef struct _HTTP_CHANNEL_BIND_INFO {
  HTTP_AUTHENTICATION_HARDENING_LEVELS Hardening;
  ULONG                                Flags;
  PHTTP_SERVICE_BINDING_BASE           *ServiceNames;
  ULONG                                NumberOfServiceNames;
} HTTP_CHANNEL_BIND_INFO, *PHTTP_CHANNEL_BIND_INFO;

Member

Hardening

Ein HTTP_AUTHENTICATION_HARDENING_LEVELS Wert, der die Härtestufen angibt, die pro Serversitzung oder URL-Gruppe festgelegt oder abgefragt werden sollen.

Flags

Eine bitweise OR-Kombination von Flags, die das Verhalten der Authentifizierung bestimmen.

Die folgenden Werte werden unterstützt.

Name Wert Bedeutung
HTTP_CHANNEL_BIND_PROXY 0x1 Die genaue Übereinstimmung des Kanalbindungstokens (Channel Bind Token, CBT) wird umgangen. CBT wird als nicht gleich "unbound" überprüft. Die Überprüfung des Dienstprinzipalnamens (Service Principle Name, SPN) ist aktiviert.
HTTP_CHANNEL_BIND_PROXY_COHOSTING Ox20 Dieses Flag ist nur gültig, wenn auch HTTP_CHANNEL_BIND_PROXY festgelegt ist. Wenn das Flag festgelegt ist, wird die CBT-Überprüfung (im Vergleich zu "ungebunden") übersprungen. Das Flag sollte festgelegt werden, wenn sowohl sicherer Kanaldatenverkehr, der über den Proxy übergeben wird, als auch Datenverkehr, der ursprünglich über einen unsicheren Kanal gesendet wurde, authentifiziert werden muss.
HTTP_CHANNEL_BIND_NO_SERVICE_NAME_CHECK 0x2 Die SPN-Überprüfung ist immer erfolgreich.
HTTP_CHANNEL_BIND_DOTLESS_SERVICE 0x4 Aktiviert punktlose Dienstnamen. Andernfalls schlägt das Konfigurieren von CBT-Eigenschaften mit punktlosen Dienstnamen fehl.
HTTP_CHANNEL_BIND_SECURE_CHANNEL_TOKEN 0x8 Serversitzung, URL-Gruppe oder Antwort ist so konfiguriert, dass die Sichere Kanalendpunktbindung für jede Anforderung abgerufen und an den Benutzer der Modusanwendung übergeben wird. Wenn festgelegt, wird ein Zeiger auf einen Puffer mit der Endpunktbindung des sicheren Kanals in einer HTTP_REQUEST_CHANNEL_BIND_STATUS-Struktur gespeichert.
HTTP_CHANNEL_BIND_CLIENT_SERVICE 0x10 Serversitzung, URL-Gruppe oder Antwort ist so konfiguriert, dass der SPN für jede Anforderung abgerufen und an die Benutzermodusanwendung übergeben wird. Der SPN wird im Feld ServiceName der HTTP_REQUEST_CHANNEL_BIND_STATUS-Struktur gespeichert. Der Typ ist immer HttpServiceBindingTypeW (Unicode).

ServiceNames

Zeiger auf einen Puffer, der ein Array von 1 oder mehr Dienstnamen enthält. Jeder Dienstname wird entweder durch eine HTTP_SERVICE_BINDING_A-Struktur oder eine HTTP_SERVICE_BINDING_W-Struktur dargestellt, je nachdem, ob der Name ASCII oder Unicode ist. Unabhängig davon, welcher Strukturtyp verwendet wird, wird das Array in einen Zeiger auf eine HTTP_SERVICE_BINDING_BASE-Struktur umgewandelt.

NumberOfServiceNames

Die Anzahl der Namen in ServiceNames.

Hinweise

Hinweis  

Diese Struktur wird verwendet, um Eigenschaften von Serversitzungen oder URL-Gruppen festzulegen, indem sie an HttpSetServerSessionProperty oder HttpSetUrlGroupProperty übergeben werden.

Die HTTP_CHANNEL_BIND_INFO-Struktur wird auch zurückgegeben, wenn Serversitzungs- oder URL-Gruppeneigenschaften abgefragt werden.

 

Anforderungen

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