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

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

Parameters

ServiceHandle

This parameter is reserved and must be zero.

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.

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.

ConfigInformationLength

Size, in bytes, of the pConfigInformation buffer.

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

   
Windows version Windows Vista, Windows XP with SP2 [desktop apps only] 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