HttpDeleteServiceConfiguration function

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

ULONG HttpDeleteServiceConfiguration(
  _In_ HANDLE                 ServiceHandle,
  _In_ HTTP_SERVICE_CONFIG_ID ConfigId,
  _In_ PVOID                  pConfigInformation,
  _In_ ULONG                  ConfigInformationLength,
  _In_ LPOVERLAPPED           pOverlapped
);

Parameters

ServiceHandle [in]

This parameter is reserved and must be zero.

ConfigId [in]

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.

 

pConfigInformation [in]

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.

 

ConfigInformationLength [in]

Size, in bytes, of the pConfigInformation buffer.

pOverlapped [in]

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.

Requirements

See also

HTTP Server API Version 1.0 Functions

HttpSetServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration