HTTP_MULTIPLE_KNOWN_HEADERS structure

The HTTP_MULTIPLE_KNOWN_HEADERS structure specifies the headers that are included in an HTTP response when more than one header is required.

Syntax


typedef struct {
  HTTP_HEADER_ID     HeaderId;
  ULONG              Flags;
  USHORT             KnownHeaderCount;
  PHTTP_KNOWN_HEADER KnownHeaders;
} HTTP_MULTIPLE_KNOWN_HEADERS, *PHTTP_MULTIPLE_KNOWN_HEADERS;

Members

HeaderId

A member of the HTTP_HEADER_ID enumeration specifying the response header ID.

Flags

The flags corresponding to the response header in the HeaderId member. This member is used only when the WWW-Authenticate header is present. This can be zero or the following:

FlagMeaning
HTTP_RESPONSE_INFO_FLAGS_PRESERVE_ORDER

The specified order of authentication schemes is preserved on the challenge response.

 

KnownHeaderCount

The number of elements in the array specified in the KnownHeaders member.

KnownHeaders

A pointer to the first element in the array of HTTP_KNOWN_HEADER structures.

Remarks

The HTTP version 1.0 API allows applications to send only one known response header with the response. Starting with the HTTP version 2.0 API, applications are enabled to send multiple known response headers.

The pInfo member of the HTTP_RESPONSE_INFO structure points to this structure when the application provides multiple known headers on a response. The HTTP_RESPONSE_INFO structure extends the HTTP_RESPONSE structure starting with HTTP version 2.0.

The HTTP_MULTIPLE_KNOWN_HEADERS structure enables server applications to send multiple authentication challenges to the client.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Http.h

See also

HTTP Server API Version 2.0 Structures
HTTP_RESPONSE_INFO
HTTP_RESPONSE_V2

 

 

Show: