Поделиться через


перечисление HTTP_HEADER_ID (http.h)

Тип перечисления HTTP_HEADER_IDперечисляет известные заголовки для HTTP-запросов и ответов и связывает индекс массива с каждым таким заголовком. Он используется для изменения размера элементов массива KnownHeaders и доступа к ним в структурах HTTP_REQUEST_HEADERS и HTTP_RESPONSE_HEADERS .

Синтаксис

typedef enum _HTTP_HEADER_ID {
  HttpHeaderCacheControl = 0,
  HttpHeaderConnection = 1,
  HttpHeaderDate = 2,
  HttpHeaderKeepAlive = 3,
  HttpHeaderPragma = 4,
  HttpHeaderTrailer = 5,
  HttpHeaderTransferEncoding = 6,
  HttpHeaderUpgrade = 7,
  HttpHeaderVia = 8,
  HttpHeaderWarning = 9,
  HttpHeaderAllow = 10,
  HttpHeaderContentLength = 11,
  HttpHeaderContentType = 12,
  HttpHeaderContentEncoding = 13,
  HttpHeaderContentLanguage = 14,
  HttpHeaderContentLocation = 15,
  HttpHeaderContentMd5 = 16,
  HttpHeaderContentRange = 17,
  HttpHeaderExpires = 18,
  HttpHeaderLastModified = 19,
  HttpHeaderAccept = 20,
  HttpHeaderAcceptCharset = 21,
  HttpHeaderAcceptEncoding = 22,
  HttpHeaderAcceptLanguage = 23,
  HttpHeaderAuthorization = 24,
  HttpHeaderCookie = 25,
  HttpHeaderExpect = 26,
  HttpHeaderFrom = 27,
  HttpHeaderHost = 28,
  HttpHeaderIfMatch = 29,
  HttpHeaderIfModifiedSince = 30,
  HttpHeaderIfNoneMatch = 31,
  HttpHeaderIfRange = 32,
  HttpHeaderIfUnmodifiedSince = 33,
  HttpHeaderMaxForwards = 34,
  HttpHeaderProxyAuthorization = 35,
  HttpHeaderReferer = 36,
  HttpHeaderRange = 37,
  HttpHeaderTe = 38,
  HttpHeaderTranslate = 39,
  HttpHeaderUserAgent = 40,
  HttpHeaderRequestMaximum = 41,
  HttpHeaderAcceptRanges = 20,
  HttpHeaderAge = 21,
  HttpHeaderEtag = 22,
  HttpHeaderLocation = 23,
  HttpHeaderProxyAuthenticate = 24,
  HttpHeaderRetryAfter = 25,
  HttpHeaderServer = 26,
  HttpHeaderSetCookie = 27,
  HttpHeaderVary = 28,
  HttpHeaderWwwAuthenticate = 29,
  HttpHeaderResponseMaximum = 30,
  HttpHeaderMaximum = 41
} HTTP_HEADER_ID, *PHTTP_HEADER_ID;

Константы

 
HttpHeaderCacheControl
Значение: 0
Используется для указания поведения кэширования в цепочке запросов или ответов, переопределяя алгоритм кэширования по умолчанию.
HttpHeaderConnection
Значение: 1
Позволяет отправителю указать параметры, необходимые для конкретного подключения. Они используются только для одного подключения и не должны передаваться прокси-серверами через дальнейшие подключения.
HttpHeaderDate
Значение: 2
Date — это общее поле заголовка, указывающее время отправки запроса или ответа.
HttpHeaderKeepAlive
Значение: 3
На основе элемента keepalive XML (см. RFC 2518, раздел 12.12.1, страница 66); список универсальных кодов ресурса (URI), включенных в KeepAlive;
После копирования заголовка должен быть "динамическим"
(перемещен) в место назначения.
HttpHeaderPragma
Значение: 4
Используется для включения необязательных директив, зависящих от реализации, которые могут применяться к любому получателю в цепочке запросов и ответов.
HttpHeaderTrailer
Значение: 5
Указывает, что указанные поля заголовка присутствуют в трейлере сообщения, закодированного с помощью фрагментированного кода передачи.
HttpHeaderTransferEncoding
Значение: 6
Указывает, какие преобразования были применены к тексту сообщения при передаче.
HttpHeaderUpgrade
Значение: 7
Позволяет клиенту указать один или несколько других протоколов связи, которые он предпочел бы использовать, если сервер может соответствовать требованиям.
HttpHeaderVia
Значение: 8
Поле Заголовок Via указывает путь, принятый запросом.
HttpHeaderWarning
Значение: 9
Это заголовок ответа, содержащий 3-значный код предупреждения вместе с фразой причины.
HttpHeaderAllow
Значение: 10
Списки набор методов, поддерживаемых ресурсом, определенным по запросу URI.
HttpHeaderContentLength
Значение: 11
Размер текста сообщения в десятичных байтах.
HttpHeaderContentType
Значение: 12
Тип носителя текста сообщения.
HttpHeaderContentEncoding
Значение: 13
Схема кодирования для текста сообщения.
HttpHeaderContentLanguage
Значение: 14
Предоставляет естественный язык целевой аудитории.
HttpHeaderContentLocation
Значение: 15
Расположение ресурса для сущности, заключенной в сообщение, когда эта сущность доступна из расположения, отделенного от URI запрошенного ресурса.
HttpHeaderContentMd5
Значение: 16
Хэш MD5 тела сущности, используемый для обеспечения сквозной целостности сообщений проверка (MIC) тела сущности.
HttpHeaderContentRange
Значение: 17
Заголовок диапазона содержимого отправляется с частичным текстом сущности, чтобы указать, где в полном теле сущности должен применяться частичный текст.
HttpHeaderExpires
Значение: 18
Дата и время истечения срока действия содержимого сообщения.
HttpHeaderLastModified
Значение: 19
Указывает дату и время, когда сервер-источник считает, что вариант был изменен в последний раз.
HttpHeaderAccept
Значение: 20
Используется с методами INVITE, OPTIONS и REGISTER, чтобы указать, какие типы мультимедиа допустимы в ответе.
HttpHeaderAcceptCharset
Значение: 21
Указывает наборы символов, приемлемые для ответа.
HttpHeaderAcceptEncoding
Значение: 22
Кодировки содержимого, приемлемые в ответе.
HttpHeaderAcceptLanguage
Значение: 23
Используется клиентом, чтобы указать серверу, на каком языке он предпочел бы получать фразы причины, описания сеанса или ответы о состоянии.
HttpHeaderAuthorization
Значение: 24
Агент пользователя может пройти проверку подлинности на сервере, отправив поле заголовка запроса авторизации с запросом. Поле содержит учетные данные для домена, запрашиваемого пользователем.
HttpHeaderCookie
Значение: 25
Заголовок запроса cookie содержит данные, используемые для поддержания состояния клиента на сервере. Данные cookie получаются из ответа, отправленного с помощью HttpHeaderSetCookie.
HttpHeaderExpect
Значение: 26
Указывает конкретное поведение сервера, которое требуется клиенту.
HttpHeaderFrom
Значение: 27
Поле заголовка From указывает инициатор запроса SIP или ответного сообщения.
HttpHeaderHost
Значение: 28
Указывает узел Интернета и номер порта запрошенного ресурса. Он получается из исходного URI, предоставленного пользователем или ссылающимся ресурсом.
HttpHeaderIfMatch
Значение: 29
Поле заголовка запроса If-Match используется с методом , чтобы сделать его условным. Клиент, имеющий одну или несколько сущностей, ранее полученных от ресурса, может проверить, является ли одна из этих сущностей текущей, включив список связанных тегов сущностей в поле заголовка If-Match.
HttpHeaderIfModifiedSince
Значение: 30
Поле заголовка запроса If-Modified-Since используется с методом , чтобы сделать его условным. Если запрошенный вариант не был изменен с момента, указанного в этом поле, сущность не возвращается с сервера; Вместо этого возвращается ответ 304 (без изменений) без текста сообщения.
HttpHeaderIfNoneMatch
Значение: 31
Поле If-None-Match request-header используется с методом для создания
это условное. Если клиент получил одну или несколько сущностей из ресурса, он может убедиться, что ни одна из этих сущностей не является
current путем включения списка связанных тегов сущностей в
Поле заголовка If-None-Match. Назначение этой функции — разрешить
эффективное обновление кэшированных сведений с минимальным объемом
затраты на транзакции и, чтобы предотвратить метод, например PUT
от непреднамеренного изменения существующего ресурса, когда клиент
считает, что ресурс не существует.
HttpHeaderIfRange
Значение: 32
Если клиент имеет частичную копию сущности в своем кэше, и желает
чтобы получить актуальную копию всей сущности, он
может использовать заголовок If-Range. В неофициальном случае его значение: "Если сущность не изменилась, отправьте
мне части, которые я отсутствуют; в противном случае отправьте мне все новое
сущности.
HttpHeaderIfUnmodifiedSince
Значение: 33
Поле заголовка запроса If-Unmodified-Since используется с методом для
сделать его условным. Если запрошенный ресурс не был изменен
с момента, указанного в этом поле, сервер выполняет
запрошена операция, как если бы заголовок If-Unmodified-Since не был
присутствует, но

Значение , если запрошенный ресурс был изменен,
сервер возвращает
ошибка 412 (сбой предварительного условия).
HttpHeaderMaxForwards
Значение: 34
Максимальное число прокси-серверов или шлюзов, которые могут пересылать запрос.
HttpHeaderProxyAuthorization
Значение: 35
Это поле заголовка используется клиентом для идентификации себя с помощью прокси-сервера.
HttpHeaderReferer
Значение: 36
Позволяет клиенту указать для преимущества сервера адрес (URI) ресурса, из которого был получен URI-запроса.
HttpHeaderRange
Значение: 37
Позволяет клиенту запрашивать часть сущности, а не целое.
HttpHeaderTe
Значение: 38
Это поле заголовка содержит получателя запроса или ответного сообщения SIP.
HttpHeaderTranslate
Значение: 39
Позволяет клиенту указать, требуется ли исходное представление или программная интерпретация запрошенного содержимого.
HttpHeaderUserAgent
Значение: 40
Указывает, какие коды передачи расширений клиент принимает в ответе и принимает ли клиент поля трейлера в фрагментированных кодах передачи.
HttpHeaderRequestMaximum
Значение: 41
Не значение, которое фактически обозначает заголовок; Вместо этого он используется для подсчета перечисленных заголовков запросов.
HttpHeaderAcceptRanges
Значение: 20
Позволяет серверу указать, что он принимает запросы диапазона для ресурса.
HttpHeaderAge
Значение: 21
Передает оценку времени отправителя с момента создания ответа (или его повторной проверки) на сервере-источнике.
HttpHeaderEtag
Значение: 22
Предоставляет текущее значение тега сущности для запрошенного варианта.
HttpHeaderLocation
Значение: 23
Используется для перенаправления получателя в расположение, отличное от URI-запроса, для завершения запроса или идентификации нового ресурса.
HttpHeaderProxyAuthenticate
Значение: 24
Поле ответа, которое должно быть включено в ответ 407. Поле содержит схему проверки подлинности и параметры, которые применяются к прокси-серверу для этого URI-запроса.
HttpHeaderRetryAfter
Значение: 25
Период времени, в течение времени, когда служба должна быть недоступна для запрашивающего клиента.
HttpHeaderServer
Значение: 26
Это поле заголовка ответа, содержащее сведения о сервере, который обрабатывает запрос.
HttpHeaderSetCookie
Значение: 27
Заголовок ответа set-cookie содержит данные, используемые для поддержания состояния клиента в будущих запросах, отправляемых с помощью HttpHeaderCookie.
HttpHeaderVary
Значение: 28
Указывает набор полей заголовка запроса, который полностью определяет, пока ответ свежий, разрешено ли кэшу использовать ответ для ответа на последующий запрос без повторной проверки.
HttpHeaderWwwAuthenticate
Значение: 29
Поле заголовка WWW_Authenticate содержит схемы и параметры проверки подлинности, применимые к URI запроса.
HttpHeaderResponseMaximum
Значение: 30
Не значение, которое фактически обозначает заголовок; Вместо этого он используется для подсчета перечисленных заголовков ответов.
HttpHeaderMaximum
Значение: 41
Не значение, которое фактически обозначает заголовок; Вместо этого он используется для подсчета всех перечисленных заголовков.

Требования

Требование Значение
Минимальная версия клиента Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть http.h

См. также раздел

HTTP_REQUEST_HEADERS

HTTP_RESPONSE_HEADERS