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

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

  • Статья

Тип перечисления HTTP_VERB определяет значения, которые используются для указания известных стандартных HTTP-команд в структуре HTTP_REQUEST . Большинство из этих известных глаголов задокументированы в RFC 2616 и RFC 2518, как показано ниже.

Синтаксис

typedef enum _HTTP_VERB {
  HttpVerbUnparsed,
  HttpVerbUnknown,
  HttpVerbInvalid,
  HttpVerbOPTIONS,
  HttpVerbGET,
  HttpVerbHEAD,
  HttpVerbPOST,
  HttpVerbPUT,
  HttpVerbDELETE,
  HttpVerbTRACE,
  HttpVerbCONNECT,
  HttpVerbTRACK,
  HttpVerbMOVE,
  HttpVerbCOPY,
  HttpVerbPROPFIND,
  HttpVerbPROPPATCH,
  HttpVerbMKCOL,
  HttpVerbLOCK,
  HttpVerbUNLOCK,
  HttpVerbSEARCH,
  HttpVerbMaximum
} HTTP_VERB, *PHTTP_VERB;

Константы

 
HttpVerbUnparsed
Не относится к приложениям; используется только в режиме ядра.
HttpVerbUnknown
Указывает, что приложение может проверить элементы UnknownVerbLength и pUnknownVerbструктуры HTTP_REQUEST , чтобы получить HTTP-команду для запроса. Это происходит в запросе HTTP/1.1, когда клиент браузера указывает пользовательскую команду.
HttpVerbInvalid
Не относится к приложениям; используется только в режиме ядра.
HttpVerbOPTIONS
Метод OPTIONS запрашивает сведения о параметрах связи и требованиях, связанных с URI.


См. страницу 52 документа RFC 2616.
HttpVerbGET
Метод GET извлекает сведения или сущность, определяемые универсальным кодом ресурса (URI) запроса. Если этот URI ссылается на скрипт или другой процесс создания данных, в ответе возвращаются созданные данные, а не текст скрипта.

Метод GET можно сделать условным или частичным, включив в запрос поле условного или диапазона заголовка. Условный ЗАПРОС GET запрашивает отправку сущности только в том случае, если выполняются все условия, указанные в заголовке , а частичный запрос GET запрашивает только часть сущности, как указано в заголовке Range. Обе эти формы GET помогают избежать ненужного сетевого трафика.


См. страницу 53 документа RFC 2616.
HttpVerbHEAD
Метод HEAD идентичен методу GET за исключением того, что сервер возвращает в ответе только заголовки сообщений без основного текста сообщений. Заголовки совпадают с возвращаемыми в ответ на запрос GET.


См. страницу 54 документа RFC 2616.
HttpVerbPOST
Метод POST используется для публикации новой сущности в качестве дополнения к URI.
Универсальный код ресурса (URI) идентифицирует сущность, которая каким-либо образом использует опубликованные данные.


См. страницу 54 документа RFC 2616.
HttpVerbPUT
Метод PUT используется для замены сущности, определяемой URI.


См. страницу 55 документа RFC 2616.
HttpVerbDELETE
The
Метод DELETE запрашивает удаление указанного URI.


См. страницу 56 RFC 2616.
HttpVerbTRACE
Метод TRACE вызывает удаленный цикл на уровне приложения для сообщения запроса.
Это позволяет клиенту видеть, что получается у другого
конец цепочки запросов для диагностики
Целей. См. страницу 56 RFC 2616.
HttpVerbCONNECT
The CONNECT
Метод можно использовать с прокси-сервером, который может динамически переключаться на туннелирование, как в случае туннелирования SSL. См. страницу 57 документа RFC 2616.
HttpVerbTRACK
Метод TRACK используется сервером кластеров Майкрософт для реализации трассировки без ведения журнала.
HttpVerbMOVE
Метод MOVE запрашивает операцию WebDAV
эквивалент копирования (COPY) с последующим обслуживанием согласованности
обработка с последующим удалением источника, где все три
действия выполняются атомарно. При применении к коллекции предполагается, что "Depth" имеет значение или должно быть указано как "бесконечность". См. страницу 42 документа RFC 2518.
HttpVerbCOPY
Метод COPY запрашивает операцию WebDAV, которая создает дубликат исходного ресурса.
определяется URI запроса в целевом ресурсе,
определяется универсальным кодом ресурса (URI), указанным в заголовке Destination. См. страницу 37 документа RFC 2518.
HttpVerbPROPFIND
Метод PROPFIND запрашивает операцию WebDAV, которая извлекает свойства, определенные для ресурса.
определяется с помощью URI запроса. См. страницу 24 документа RFC 2518.
HttpVerbPROPPATCH
Метод PROPPATCH запрашивает операцию WebDAV, которая задает и (или) удаляет свойства, определенные для ресурса.
определяется с помощью URI запроса. См. страницу 31 RFC 2518.
HttpVerbMKCOL
Метод MKCOL запрашивает операцию WebDAV, которая создает новую коллекцию.
ресурс в расположении, указанном параметром
URI запроса. См. страницу 33 в RFC 2518.
HttpVerbLOCK
Метод LOCK запрашивает операцию WebDAV, которая создает блокировку в соответствии с параметром lockinfo.
XML-элемент в request-URI. См. страницу 45 RFC 2518.
HttpVerbUNLOCK
Метод UNLOCK запрашивает операцию WebDAV, которая удаляет блокировку, определяемую маркером блокировки в
Lock-Token заголовок запроса, из ресурса, определенного с помощью URI запроса, и из всех остальных
ресурсы, включенные в блокировку. См. страницу 51 RFC 2518.
HttpVerbSEARCH
Метод SEARCH запрашивает операцию WebDAV, используемую
Microsoft Exchange для поиска в папках. Дополнительные сведения см. в разделе Internet Engineering Task Force (IETF) Internet Draft WebDAV SEARCH, а также на веб-сайте WebDAV для возможных обновлений.
HttpVerbMaximum
Завершает перечисление; не используется для определения команды.

Требования

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

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

HTTP_REQUEST