使用英语阅读

通过


http.h 标头

HTTP 服务器 API 使用此标头。 有关详细信息,请参阅:

http.h 包含以下编程接口:

函数

 
HTTP_EQUAL_VERSION

如果HTTP_VERSION结构等于指定的主版本/次要版本组合,则返回非零值,否则返回零。
HTTP_GREATER_EQUAL_VERSION

如果HTTP_VERSION结构大于或等于指定的主版本/次要版本组合,则HTTP_GREATER_EQUAL_VERSION宏返回非零值,否则返回零。
HTTP_GREATER_VERSION

如果HTTP_VERSION结构大于指定的主版本/次要版本组合,则返回非零值,否则返回零。
HTTP_IS_NULL_ID

确定HTTP_OPAQUE_ID是否为 NULL。
HTTP_LESS_EQUAL_VERSION

如果HTTP_VERSION结构小于或等于指定的主/次要版本组合,则返回非零值,否则返回零。
HTTP_LESS_VERSION

如果HTTP_VERSION结构小于指定的主/次版本组合,则返回非零值,否则返回零。
HTTP_NOT_EQUAL_VERSION

如果HTTP_VERSION结构大于或小于指定的主要/次要版本组合,则返回非零值;如果相等,则返回零值。
HTTP_SET_NULL_ID

HTTP_SET_NULL_ID宏将HTTP_OPAQUE_ID设置为 NULL。
HTTP_SET_VERSION

将指定的HTTP_VERSION结构设置为指定的主/次版本组合。
HttpAddFragmentToCache

HttpAddFragmentToCache 函数缓存具有指定名称的数据片段,通过该名称可以检索数据片段,或更新在指定名称下缓存的数据。
HttpAddUrl

注册给定 URL,以便匹配该 URL 的请求路由到指定的 HTTP 服务器 API 请求队列。
HttpAddUrlToUrlGroup

将指定的 URL 添加到由 URL 组 ID 标识的 URL 组。
HTTPAPI_EQUAL_VERSION

如果HTTPAPI_VERSION结构与指定的主版本/次要版本组合完全相等,则返回非零值,否则返回零。
HTTPAPI_GREATER_VERSION

如果HTTPAPI_VERSION结构大于指定的主版本/次要版本组合,则返回非零值,否则返回零。
HTTPAPI_LESS_VERSION

如果HTTPAPI_VERSION结构小于指定的主版本/次要版本组合,则返回一个非零值,否则返回零。
HTTPAPI_VERSION_GREATER_OR_EQUAL

如果HTTPAPI_VERSION结构大于或等于指定的主版本/次要版本组合,则HTTPAPI_VERSION_GREATER_OR_EQUAL返回非零值,否则返回零。
HttpCancelHttpRequest

HttpCancelHttpRequest 函数取消指定的请求。
HttpCloseRequestQueue

关闭由 HttpCreateRequestQueue 创建的指定请求队列的句柄。
HttpCloseServerSession

删除由服务器会话 ID 标识的服务器会话。
HttpCloseUrlGroup

关闭由 URL 组 ID 标识的 URL 组。
HttpCreateHttpHandle

为调用应用程序创建 HTTP 请求队列,并返回一个句柄。
HttpCreateRequestQueue

创建新的请求队列或打开现有请求队列。
HttpCreateServerSession

为指定版本创建服务器会话。
HttpCreateUrlGroup

在指定的服务器会话下创建 URL 组。
HttpDeclarePush

声明要用于 HTTP 服务器推送的资源到子资源关系。 如果基础协议、连接、客户端和策略允许推送操作,则 HTTP.sys 对给定资源执行 HTTP 2.0 服务器推送。
HttpDelegateRequestEx

将源请求队列中的请求委托给目标请求队列。
HttpDeleteServiceConfiguration

从 HTTP 服务器 API 配置存储区中删除指定的数据,例如 IP 地址或 SSL 证书,一次一条记录。
HttpFindUrlGroupId

检索 URL 和请求队列的 URL 组 ID。
HttpFlushResponseCache

从与给定请求队列关联的 HTTP 服务器 API 缓存中删除其网站部分与指定 UrlPrefix 匹配的名称的所有响应片段。
HttpInitialize

HttpInitialize 函数初始化 HTTP 服务器 API 驱动程序,启动它(如果尚未启动),并为调用应用程序分配数据结构以支持响应队列创建和其他操作。
HttpIsFeatureSupported

检查是否支持特定功能。
HttpPrepareUrl

分析、分析和规范化非规范化 Unicode 或 punycode URL,使其在其他 HTTP 函数中使用是安全且有效的。
HttpQueryRequestQueueProperty

查询由指定句柄标识的请求队列的属性。
HttpQueryServerSessionProperty

查询指定服务器会话上的服务器属性。
HttpQueryServiceConfiguration

检索一个或多个 HTTP 服务器 API 配置记录。
HttpQueryUrlGroupProperty

查询指定 URL 组上的属性。
HttpReadFragmentFromCache

HttpReadFragmentFromCache 函数从 HTTP 服务器 API 缓存中检索具有指定名称的响应片段。
HttpReceiveClientCertificate

服务器应用程序使用 HttpReceiveClientCertificate 函数检索客户端 SSL 证书或通道绑定令牌 (CBT) 。
HttpReceiveHttpRequest

以同步或异步方式从指定的请求队列中检索下一个可用的 HTTP 请求。
HttpReceiveRequestEntityBody

接收指定 HTTP 请求的其他实体正文数据。
HttpRemoveUrl

使系统停止将匹配指定 UrlPrefix 字符串的请求路由到指定的请求队列。
HttpRemoveUrlFromUrlGroup

从 URL 组 ID 标识的组中删除指定的 URL。
HttpSendHttpResponse

向指定的 HTTP 请求发送 HTTP 响应。
HttpSendResponseEntityBody

发送与 HTTP 响应关联的实体正文数据。
HttpSetRequestProperty

设置新属性或修改指定请求中的现有属性。
HttpSetRequestQueueProperty

设置由指定句柄标识的请求队列上的新属性或修改现有属性。
HttpSetServerSessionProperty

设置新的服务器会话属性或修改指定服务器会话上的现有属性。
HttpSetServiceConfiguration

创建并设置 HTTP 服务器 API 配置存储的配置记录。
HttpSetUrlGroupProperty

设置新属性或修改指定 URL 组中的现有属性。
HttpShutdownRequestQueue

停止对指定请求队列进程的排队请求。
HttpTerminate

清理 HTTP 服务器 API 用于处理应用程序调用的资源。
HttpUpdateServiceConfiguration

以原子方式汇报服务配置参数,该参数在 HTTP 服务器 API 配置存储中的配置记录中指定传输层安全性 (TLS) 证书。
HttpWaitForDemandStart

等待可由新请求队列进程提供的新请求的到来。
HttpWaitForDisconnect

当与 HTTP 客户端的连接因任何原因中断时,通知应用程序。
HttpWaitForDisconnectEx

此函数是 HttpWaitForDisconnect 的扩展。

结构

 
HTTP_BANDWIDTH_LIMIT_INFO

HTTP_BANDWIDTH_LIMIT_INFO结构用于设置或查询带宽限制。 在 URL 组或服务器会话上设置或查询 HttpServerBandwidthProperty 时,必须使用此结构。
HTTP_BINDING_INFO

用于将 URL 组与请求队列相关联。
HTTP_BYTE_RANGE

HTTP_BYTE_RANGE结构用于指定缓存响应片段、文件或其他数据块中的字节范围。
HTTP_CACHE_POLICY

用于定义与缓存响应片段关联的缓存策略。
HTTP_CHANNEL_BIND_INFO

HTTP_CHANNEL_BIND_INFO。
HTTP_CONNECTION_LIMIT_INFO

用于设置或查询 URL 组的最大未完成连接数的限制。
HTTP_COOKED_URL

包含经过验证的规范 UTF-16 Unicode 编码的 URL 请求字符串,以及指向它的指针和元素长度。
HTTP_DATA_CHUNK

表示内存、文件或 HTTP 服务器 API 响应片段缓存中的单个数据块。
HTTP_DELEGATE_REQUEST_PROPERTY_INFO

描述委托请求时的其他属性信息。
HTTP_FLOWRATE_INFO

响应的传输速率。
HTTP_KNOWN_HEADER

包含来自 HTTP 请求或 HTTP 响应的已知标头的标头值。
HTTP_LISTEN_ENDPOINT_INFO

控制基于 IP 的 URL 是应侦听特定 IP 地址还是侦听通配符。
HTTP_LOG_DATA

包含一个值,该值指定日志数据类型。
HTTP_LOG_FIELDS_DATA

用于在启用 WC3 日志记录时传递为 HTTP 响应记录的字段。
HTTP_LOGGING_INFO

用于在 URL 组或服务器会话上启用服务器端日志记录。
HTTP_MULTIPLE_KNOWN_HEADERS

指定当需要多个标头时 HTTP 响应中包含的标头。
HTTP_PROPERTY_FLAGS

由属性配置结构用于在设置属性配置时启用或禁用配置对象上的属性。
HTTP_QOS_SETTING_INFO

包含有关 QOS 设置的信息。
HTTP_REQUEST_AUTH_INFO

包含请求的身份验证状态,其中包含客户端令牌的句柄,接收进程可以使用该句柄来模拟经过身份验证的客户端。
HTTP_REQUEST_CHANNEL_BIND_STATUS

HTTP_REQUEST_CHANNEL_BIND_STATUS。
HTTP_REQUEST_HEADERS

包含使用 HTTP 请求发送的标头。
HTTP_REQUEST_INFO

使用有关请求的其他信息扩展HTTP_REQUEST结构。
HTTP_REQUEST_PROPERTY_STREAM_ERROR

HTTP_REQUEST_PROPERTY_STREAM_ERROR结构表示 HTTP/2 或 HTTP/3 流错误代码。
HTTP_REQUEST_TIMING_INFO

包含有关每个请求处理阶段所花费的时间的信息。
HTTP_REQUEST_V1

使用 HTTP_REQUEST 结构返回与特定请求关联的数据。
HTTP_REQUEST_V2

使用有关请求的详细信息扩展HTTP_REQUEST_V1请求结构。
HTTP_RESPONSE_HEADERS

包含使用 HTTP 响应发送的标头。
HTTP_RESPONSE_INFO

使用响应的其他信息扩展HTTP_RESPONSE结构。
HTTP_RESPONSE_V1

包含与 HTTP 响应关联的数据。
HTTP_RESPONSE_V2

使用响应的详细信息扩展 HTTP 1.0 版响应结构。
HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS

HTTP_SERVER_AUTHENTICATION_BASIC_PARAMS 结构包含 URL 组上基本身份验证的信息。此结构包含在 HTTP_SERVER_AUTHENTICATION_INFO 结构中。
HTTP_SERVER_AUTHENTICATION_DIGEST_PARAMS

包含 URL 组的摘要式身份验证信息。
HTTP_SERVER_AUTHENTICATION_INFO

用于在 URL 组或服务器会话上启用服务器端身份验证。
HTTP_SERVICE_BINDING_A

HTTP_SERVICE_BINDING_A。
HTTP_SERVICE_BINDING_BASE

HTTP_SERVICE_BINDING_BASE。
HTTP_SERVICE_BINDING_W

HTTP_SERVICE_BINDING_W。
HTTP_SERVICE_CONFIG_CACHE_SET

在 HttpSetServiceConfiguration 函数的 pConfigInformation 参数中使用。
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM

用于指定要在 HTTP 服务绑定到的 IP 地址列表中添加或删除的 IP 地址。
HTTP_SERVICE_CONFIG_IP_LISTEN_QUERY

HttpQueryServiceConfiguration 用于返回 INTERNET 协议列表, (HTTP 服务绑定到的 IP) 地址。
HTTP_SERVICE_CONFIG_SSL_CCS_KEY

用作标识 SSL 证书记录的密钥,该记录指定如果端口收到传输层安全性 (TLS) 握手,Http.sys 应查阅集中式证书存储 (CCS) 存储来查找证书。
HTTP_SERVICE_CONFIG_SSL_CCS_QUERY

指定安全套接字层 (SSL) 配置,以便在调用 HttpQueryServiceConfiguration 函数时,在端口上查询 SSL 集中式证书存储 (CCS) 记录。
HTTP_SERVICE_CONFIG_SSL_CCS_SET

表示 SSL 证书记录,该记录指定如果端口收到传输层安全性 (TLS) 握手,Http.sys 应查阅集中式证书存储 (CCS) 存储来查找证书。
HTTP_SERVICE_CONFIG_SSL_KEY

用作用于标识给定安全套接字层 (SSL) 证书记录的密钥。
HTTP_SERVICE_CONFIG_SSL_PARAM

在 SSL 配置存储区中定义记录。
HTTP_SERVICE_CONFIG_SSL_QUERY

用于指定要在 SSL 配置存储中查询的特定记录。
HTTP_SERVICE_CONFIG_SSL_SET

用于将新记录添加到 SSL 存储或从中检索现有记录。
HTTP_SERVICE_CONFIG_SSL_SNI_KEY

用作在 SSL SNI 存储中标识给定安全套接字层 (SSL) 服务器名称指示 (SNI) 证书记录的密钥。
HTTP_SERVICE_CONFIG_SSL_SNI_QUERY

用于指定要在 SSL SNI 存储中查询的特定安全套接字层 (SSL) 服务器名称指示 (SNI) 证书记录。
HTTP_SERVICE_CONFIG_SSL_SNI_SET

用于将新的安全套接字层 (SSL) 服务器名称指示 (SNI) 证书记录添加到 SSL SNI 存储或从中检索现有记录。
HTTP_SERVICE_CONFIG_TIMEOUT_SET

用于设置 HTTP 服务器 API 宽超时值。
HTTP_SERVICE_CONFIG_URLACL_KEY

用于指定 URL 命名空间预留存储区中的特定预留记录。
HTTP_SERVICE_CONFIG_URLACL_PARAM

用于指定与 URL 命名空间预留存储区中的特定记录关联的权限。
HTTP_SERVICE_CONFIG_URLACL_QUERY

用于指定要在 URL 命名空间预留存储中查询的特定预留记录。
HTTP_SERVICE_CONFIG_URLACL_SET

用于将新记录添加到 URL 预留存储或从中检索现有记录。
HTTP_SSL_CLIENT_CERT_INFO

包含有关安全套接字层 (SSL) 客户端证书的数据,该证书可用于确定证书是否有效。
HTTP_SSL_INFO

包含使用安全套接字层 (SSL) 的连接的数据,该连接通过 SSL 握手获取。
HTTP_STATE_INFO

用于启用或禁用服务器会话或 URL 组。
HTTP_TIMEOUT_LIMIT_INFO

定义特定于应用程序的连接超时限制。
HTTP_TRANSPORT_ADDRESS

指定用于特定 HTTP 连接的地址 (本地和远程) 。
HTTP_UNKNOWN_HEADER

包含 HTTP 请求或响应中其名称未出现在枚举中的标头的名称和值。
HTTP_VERSION

定义请求要求或响应提供的 HTTP 协议版本。
HTTPAPI_VERSION

定义 HTTP 服务器 API 的版本。

枚举

 
HTTP_503_RESPONSE_VERBOSITY

HTTP_503_RESPONSE_VERBOSITY 枚举定义 503、服务不可用、错误响应的详细级别。在请求队列上设置或查询 HttpServer503ResponseProperty 时,必须使用此结构。
HTTP_AUTH_STATUS

定义请求的身份验证状态。
HTTP_AUTHENTICATION_HARDENING_LEVELS

服务器强化级别。
HTTP_CACHE_POLICY_TYPE

HTTP_CACHE_POLICY_TYPE 枚举类型定义可用的缓存策略。
HTTP_DATA_CHUNK_TYPE

定义数据区块的数据源。
HTTP_DELEGATE_REQUEST_PROPERTY_ID

描述委托请求的属性信息。
HTTP_ENABLED_STATE

定义请求队列、服务器会话或 URL 组的状态。
HTTP_FEATURE_ID

定义指定 HTTP 功能的标识符的常量。
HTTP_HEADER_ID

HTTP_HEADER_ID枚举类型列出了 HTTP 请求和响应的已知标头,并将数组索引与每个此类标头相关联。
HTTP_LOG_DATA_TYPE

标识日志数据类型。
HTTP_LOGGING_ROLLOVER_TYPE

定义日志文件滚动更新类型。
HTTP_LOGGING_TYPE

定义执行的日志记录的类型。
HTTP_QOS_SETTING_TYPE

标识包含在HTTP_QOS_SETTING_INFO结构中的 QOS 设置的类型。
HTTP_REQUEST_AUTH_TYPE

HTTP_REQUEST_AUTH_TYPE枚举定义 HTTP 服务器 API 支持的身份验证类型。此枚举在 HTTP_REQUEST_AUTH_INFO 结构中使用。
HTTP_REQUEST_INFO_TYPE

HTTP_REQUEST_INFO_TYPE 枚举定义HTTP_REQUEST_INFO结构中包含的信息类型。
HTTP_REQUEST_PROPERTY

定义由 HTTP 服务器 API 在请求中配置的属性。
HTTP_REQUEST_TIMING_TYPE

定义常量,这些常量指定将在 HTTP_REQUEST_TIMING_INFO中返回的信息的可能请求时间。
HTTP_RESPONSE_INFO_TYPE

HTTP_RESPONSE_INFO_TYPE 枚举定义HTTP_RESPONSE_INFO结构中包含的信息类型。此枚举在 HTTP_RESPONSE_INFO 结构中使用。
HTTP_SERVER_PROPERTY

定义由 HTTP 服务器 API 在 URL 组、服务器会话或请求队列上配置的属性。
HTTP_SERVICE_BINDING_TYPE

HTTP_SERVICE_BINDING_TYPE枚举类型指定服务名称的字符串类型。
HTTP_SERVICE_CONFIG_CACHE_KEY

在 HttpSetServiceConfiguration 和 HttpQueryServiceConfiguration 函数中使用。
HTTP_SERVICE_CONFIG_ID

定义服务配置选项。
HTTP_SERVICE_CONFIG_QUERY_TYPE

HTTP_SERVICE_CONFIG_QUERY_TYPE 枚举类型定义要执行的各种类型的查询。 它在HTTP_SERVICE_CONFIG_SSL_QUERY、HTTP_SERVICE_CONFIG_SSL_CCS_QUERY和HTTP_SERVICE_CONFIG_URLACL_QUERY结构中使用。
HTTP_SERVICE_CONFIG_TIMEOUT_KEY

HTTP_SERVICE_CONFIG_TIMEOUT_KEY 枚举定义通过 HTTP_SERVICE_CONFIG_TIMEOUT_SET 结构查询或配置的计时器类型。
HTTP_VERB

HTTP_VERB 枚举类型定义用于在 HTTP_REQUEST 结构中指定已知的标准 HTTP 谓词的值。 这些已知谓词中的大多数记录在 RFC 2616 和 RFC 2518 中,如下所示。