HttpDeleteServiceConfiguration function (http.h)
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 |
---|---|
|
Deletes a specified IP address from the IP Listen List. |
|
Deletes a specified SSL certificate record. |
|
Deletes a specified URL reservation record. |
|
Deletes a specified connection timeout.
Windows Vista and later: This enumeration is supported. |
|
Deletes a specified SSL Server Name Indication (SNI) certificate record.
Windows 8 and later: This enumeration value is supported. |
|
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 |
---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM structure. |
|
HTTP_SERVICE_CONFIG_SSL_SET structure. |
|
HTTP_SERVICE_CONFIG_URLACL_SET structure. |
|
HTTP_SERVICE_CONFIG_TIMEOUT_KEY structure. Windows Vista and later: This structure is supported. |
|
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. |
|
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 |
---|---|
|
One of the parameters are invalid. |
|
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 |