структура HTTP_RESPONSE_V1 (http.h)

  • Статья

Структура HTTP_RESPONSE_V1 содержит данные, связанные с HTTP-ответом.

Не используйте HTTP_RESPONSE_V1 непосредственно в коде; вместо этого используйте HTTP_RESPONSE, чтобы убедиться, что используется правильная версия, основанная на операционной системе, в которую компилируется код.

Синтаксис

typedef struct _HTTP_RESPONSE_V1 {
  ULONG                 Flags;
  HTTP_VERSION          Version;
  USHORT                StatusCode;
  USHORT                ReasonLength;
  PCSTR                 pReason;
  HTTP_RESPONSE_HEADERS Headers;
  USHORT                EntityChunkCount;
  PHTTP_DATA_CHUNK      pEntityChunks;
} HTTP_RESPONSE_V1, *PHTTP_RESPONSE_V1;

Члены

Flags

Необязательные флаги ведения журнала изменяют поведение ответа по умолчанию. Это может быть любое из HTTP_RESPONSE_FLAG значений .

Version

Этот элемент игнорируется; ответ всегда является ответом HTTP/1.1.

StatusCode

Числовой код состояния, характеризующий результат HTTP-запроса (например, 200 означает "ОК", или 404, обозначающий "Не найдено"). Дополнительные сведения и список этих кодов см. в разделе 10 документа RFC 2616.

Если запрос направляется на URL-адрес, который зарезервирован, но не зарегистрирован, указывая, что соответствующее приложение для его обработки не запущено, ТО API HTTP-сервера сам возвращает ответ с кодом состояния 400, обозначающим "Недопустимый запрос". Это прозрачно для приложения. Код 400 здесь предпочтительнее 503 ("Сервер недоступен"), так как последний интерпретируется некоторыми интеллектуальными подсистемами балансировки нагрузки как признак перегрузки сервера.

ReasonLength

Размер (в байтах) строки, на которую указывает элемент pReason , не включая завершающее значение NULL. Может быть ноль.

pReason

Указатель на удобочитаемую строку печатных символов, завершающуюся нулевым значением, которая характеризует результат HTTP-запроса (например, "ОК" или "Не найдено").

Headers

Структура HTTP_RESPONSE_HEADERS , содержащая заголовки, используемые в этом ответе.

EntityChunkCount

Несколько блоков данных сущности и тела, указанных в массиве pEntityChunks . Это число не может превышать 100. Если в ответе нет тела сущности, этот элемент должен быть равен нулю.

pEntityChunks

Массив HTTP_DATA_CHUNK структур, которые вместе задают все блоки данных, составляющие тело сущности ответа.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть http.h

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

Структуры API HTTP-сервера версии 2.0

HTTP_DATA_CHUNK

HTTP_REQUEST

HTTP_RESPONSE

HTTP_RESPONSE_HEADERS

HTTP_RESPONSE_V2

HttpSendHttpResponse