Edit

Share via

HttpDeleteServiceConfiguration function (http.h)

  • Article

The HttpDeleteServiceConfiguration function deletes specified data, such as IP addresses or SSL Certificates, from the HTTP Server API configuration store, one record at a time.

Syntax

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

Parameters

[in] ServiceHandle

This parameter is reserved and must be zero.

[in] ConfigId

Type of configuration. This parameter is one of the values in the HTTP_SERVICE_CONFIG_ID enumeration.

ConfigId value Meaning
HttpServiceConfigIPListenList
 Deletes a specified IP address from the IP Listen List.
HttpServiceConfigSSLCertInfo
 Deletes a specified SSL certificate record.
HttpServiceConfigUrlAclInfo
 Deletes a specified URL reservation record.
HttpServiceConfigTimeout
 Deletes a specified connection timeout.

Windows Vista and later:  This enumeration is supported.
HttpServiceConfigSslSniCertInfo
 Deletes a specified SSL Server Name Indication (SNI) certificate record.

Windows 8 and later:  This enumeration value is supported.
HttpServiceConfigSslCcsCertInfo
 Deletes the SSL certificate record that specifies that Http.sys should consult the Centralized Certificate Store (CCS) store to find certificates if the port receives a Transport Layer Security (TLS) handshake. The port is specified by the KeyDesc member of the HTTP_SERVICE_CONFIG_SSL_CCS_SET structure that you pass to the pConfigInformation parameter.

Windows 8 and later:  This enumeration value is supported.

[in] pConfigInformation

Pointer to a buffer that contains data required for the type of configuration specified in the ConfigId parameter.

ConfigId value Meaning
HttpServiceConfigIPListenList

HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM structure.
HttpServiceConfigSSLCertInfo

HTTP_SERVICE_CONFIG_SSL_SET structure.
HttpServiceConfigUrlAclInfo

HTTP_SERVICE_CONFIG_URLACL_SET structure.
HttpServiceConfigTimeouts

HTTP_SERVICE_CONFIG_TIMEOUT_KEY structure.

Windows Vista and later:  This structure is supported.
HttpServiceConfigSslSniCertInfo

HTTP_SERVICE_CONFIG_SSL_SNI_SET structure. The hostname will be "*" when the SSL central certificate store is queried and wildcard bindings are used, and a host name for regular SNI.

Windows 8 and later:  This structure is supported.
HttpServiceConfigSslCcsCertInfo

HTTP_SERVICE_CONFIG_SSL_CCS_SET structure.

Windows 8 and later:  This structure is supported.

[in] ConfigInformationLength

Size, in bytes, of the pConfigInformation buffer.

[in] pOverlapped

Reserved for future asynchronous operation. This parameter must be set to NULL.

Return value

If the function succeeds, the function returns NO_ERROR.

If the function fails, it returns one of the following error codes.

Value Meaning
ERROR_INVALID_PARAMETER
 One of the parameters are invalid.
Other
 A system error code defined in WinError.h.

Requirements

Requirement Value
Minimum supported client Windows Vista, Windows XP with SP2 [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header http.h
Library Httpapi.lib
DLL Httpapi.dll

See also

HTTP Server API Version 1.0 Functions

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration