HttpDeleteServiceConfiguration 函数（http.h）

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

Syntax

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

参数

[in] ServiceHandle

此参数是保留的，必须为零。

[in] ConfigId

配置类型。此参数是 HTTP_SERVICE_CONFIG_ID 枚举中的值之一。

ConfigId 值	Meaning
HttpServiceConfigIPListenList	从 IP 侦听列表中删除指定的 IP 地址。
HttpServiceConfigssLCertInfo	删除指定的 SSL 证书记录。
HttpServiceConfigUrlAclInfo	删除指定的 URL 预留记录。
HttpServiceConfigTimeout	删除指定的连接超时。 Windows Vista 及更高版本：支持此枚举。
HttpServiceConfigSslSniCertInfo	删除指定的 SSL 服务器名称指示（SNI）证书记录。 Windows 8 及更高版本：支持此枚举值。
HttpServiceConfigSslCcsCertInfo	删除 SSL 证书记录，该记录指定如果端口收到传输层安全性（TLS）握手，Http.sys 应咨询集中式证书存储（CCS）存储以查找证书。端口由传递给 pConfigInformation 参数的 HTTP_SERVICE_CONFIG_SSL_CCS_SET 结构的 KeyDesc 成员指定。 Windows 8 及更高版本：支持此枚举值。

[in] pConfigInformation

指向包含 ConfigId 参数中指定的配置类型所需的数据的缓冲区的指针。

ConfigId 值	Meaning
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM 结构。
HttpServiceConfigssLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET 结构。
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET 结构。
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY 结构。 Windows Vista 及更高版本：支持此结构。
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET 结构。查询 SSL 中央证书存储并使用通配符绑定以及常规 SNI 的主机名时，主机名将为“”。 Windows 8 及更高版本：* 支持此结构。
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET 结构。 Windows 8 及更高版本：支持此结构。

[in] ConfigInformationLength

pConfigInformation 缓冲区的大小（以字节为单位）。

[in] pOverlapped

保留以供将来的异步作使用。此参数必须设置为 NULL。

返回值

如果函数成功，该函数将返回NO_ERROR。

如果函数失败，它将返回以下错误代码之一。

价值	Meaning
ERROR_INVALID_PARAMETER	其中一个参数无效。
其他	WinError.h 中定义的系统错误代码。

要求

Requirement	价值
最低支持的客户端	具有 SP2 的 Windows Vista、Windows XP [仅限桌面应用]
支持的最低服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows操作系统
Header	http.h
Library	Httpapi.lib
DLL	Httpapi.dll