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 valueMeaning
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.

 

pConfigInformation [in]

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

ConfigId valueMeaning
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.

 

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.

ValueMeaning
ERROR_INVALID_PARAMETER

One of the parameters are invalid.

Other

A system error code defined in WinError.h.

 

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Http.h

Library

Httpapi.lib

DLL

Httpapi.dll

See also

HTTP Server API Version 1.0 Functions
HttpSetServiceConfiguration
HttpQueryServiceConfiguration

 

 

Community Additions

ADD
Show:
© 2014 Microsoft