HTTP_VERB枚举 (http.h)

HTTP_VERB 枚举类型定义用于在HTTP_REQUEST结构中指定已知标准 HTTP 谓词的值。 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
指示应用程序可以检查HTTP_REQUEST结构的 UnknownVerbLengthpUnknownVerb 成员,以检索请求的 HTTP 谓词。 当浏览器客户端指定自定义谓词时,HTTP/1.1 请求就是这种情况。
HttpVerbInvalid
与应用程序无关;仅在内核模式下使用。
HttpVerbOPTIONS
OPTIONS 方法请求有关与 URI 关联的通信选项和要求的信息。


请参阅 RFC 2616 第 52 页。
HttpVerbGET
GET 方法检索由请求的 URI 标识的信息或实体。 如果该 URI 引用脚本或其他数据生成过程,则响应中返回的是生成的数据,而不是脚本的文本。

通过在请求中包含条件或 Range 标头字段,GET 方法可以成为有条件的或部分的。 条件 GET 请求仅在满足标头中指定的所有条件时发送实体,而部分 GET 仅请求实体的一部分(如 Range 标头中指定的)。 这两种形式的 GET 都有助于避免不必要的网络流量。


请参阅 RFC 2616 第 53 页。
HttpVerbHEAD
除了服务器在响应中只返回消息头不返回消息体以外,HEAD 方法和 GET 是一样的。 标头与响应 GET 时返回的标头相同。


请参阅 RFC 2616 第 54 页。
HttpVerbPOST
POST 方法用于发布新实体作为 URI 的补充。
URI 标识以某种方式使用已发布数据的实体。


请参阅 RFC 2616 第 54 页。
HttpVerbPUT
PUT 方法用于替换 URI 标识的实体。


请参阅 RFC 2616 第 55 页。
HttpVerbDELETE
The
DELETE 方法请求删除指定的 URI。


请参阅 RFC 2616 第 56 页。
HttpVerbTRACE
TRACE 方法调用请求消息的远程应用程序层环回。
它允许客户端查看正在另一个位置接收的内容
诊断请求链的末尾
目的。 请参阅 RFC 2616 第 56 页。
HttpVerbCONNECT
The CONNECT
方法可以与可以动态切换到隧道的代理一起使用,例如 SSL 隧道。 请参阅 RFC 2616 第 57 页。
HttpVerbTRACK
Microsoft 群集服务器使用 TRACK 方法实现未记录的跟踪。
HttpVerbMOVE
MOVE 方法请求 WebDAV 操作
等效于复制 (COPY) ,然后进行一致性维护
处理,然后删除源,其中所有三个
操作以原子方式执行。 应用于集合时,假定“深度”为 或 必须指定为“无穷大”。 请参阅 RFC 2518 第 42 页。
HttpVerbCOPY
COPY 方法请求创建源资源的副本的 WebDAV 操作,
由目标资源中的请求 URI 标识,
由目标标头中指定的 URI 标识。 请参阅 RFC 2518 第 37 页。
HttpVerbPROPFIND
PROPFIND 方法请求 WebDAV 操作,该操作检索在资源上定义的属性
由请求 URI 标识。 请参阅 RFC 2518 第 24 页。
HttpVerbPROPPATCH
PROPPATCH 方法请求一个 WebDAV 操作,该操作设置和/或删除在资源上定义的属性
由请求 URI 标识。 请参阅 RFC 2518 第 31 页。
HttpVerbMKCOL
MKCOL 方法请求创建新集合的 WebDAV 操作
资源位于指定的位置
请求 URI。 请参阅 RFC 2518 第 33 页。
HttpVerbLOCK
LOCK 方法请求 WebDAV 操作,该操作创建由 lockinfo 指定的锁
请求 URI 上的 XML 元素。 请参阅 RFC 2518 第 45 页。
HttpVerbUNLOCK
UNLOCK 方法请求删除由 中的锁令牌标识的锁的 WebDAV 操作
Lock-Token 请求标头、请求 URI 标识的资源以及所有其他请求标头
锁中包含的资源。 请参阅 RFC 2518 第 51 页。
HttpVerbSEARCH
SEARCH 方法请求由 使用的 WebDAV 操作
用于搜索文件夹的 Microsoft Exchange。 有关详细信息,请参阅 Internet 工程任务组 (IETF) Internet 草稿 WebDAV 搜索;有关可能的更新,请参阅 WebDAV 网站
HttpVerbMaximum
终止枚举;不用于定义谓词。

要求

要求
最低受支持的客户端 Windows Vista、Windows XP 和 SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 http.h

另请参阅

HTTP_REQUEST