Skip to content

Latest commit

 

History

History
339 lines (263 loc) · 9.59 KB

nf-http-httpsetserviceconfiguration.md

File metadata and controls

339 lines (263 loc) · 9.59 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:http.HttpSetServiceConfiguration
HttpSetServiceConfiguration function (http.h)
Creates and sets a configuration record for the HTTP Server API configuration store.
HttpServiceConfigIPListenList
HttpServiceConfigSSLCertInfo
HttpServiceConfigSslCcsCertInfo
HttpServiceConfigSslSniCertInfo
HttpServiceConfigTimeout
HttpServiceConfigUrlAclInfo
HttpSetServiceConfiguration
HttpSetServiceConfiguration function [HTTP]
_http_httpsetserviceconfiguration
http.httpsetserviceconfiguration
http/HttpSetServiceConfiguration
http\httpsetserviceconfiguration.htm
http
b0a6d442-2ff4-4e00-8301-696fb0864d8c
12/05/2018
HttpServiceConfigIPListenList, HttpServiceConfigSSLCertInfo, HttpServiceConfigSslCcsCertInfo, HttpServiceConfigSslSniCertInfo, HttpServiceConfigTimeout, HttpServiceConfigUrlAclInfo, HttpSetServiceConfiguration, HttpSetServiceConfiguration function [HTTP], _http_httpsetserviceconfiguration, http.httpsetserviceconfiguration, http/HttpSetServiceConfiguration
http.h
Windows
Windows XP with SP2 [desktop apps only]
Windows Server 2003 [desktop apps only]
Httpapi.lib
Httpapi.dll
Windows
19H1
HttpSetServiceConfiguration
http/HttpSetServiceConfiguration
c++
APIRef
kbSyntax
DllExport
Httpapi.dll
HttpSetServiceConfiguration

HttpSetServiceConfiguration function

-description

The HttpSetServiceConfiguration function creates and sets a configuration record for the HTTP Server API configuration store. The call fails if the specified record already exists. To change a given configuration record, delete it and then recreate it with a different value.

-parameters

-param ServiceHandle [in]

Reserved. Must be zero.

-param ConfigId [in]

Type of configuration record to be set. This parameter can be one of the following values from the HTTP_SERVICE_CONFIG_ID enumeration.

ConfigId value Meaning
HttpServiceConfigIPListenList
 Sets a record in the IP Listen List.
HttpServiceConfigSSLCertInfo
 Sets a specified SSL certificate record.
HttpServiceConfigUrlAclInfo
 Sets a URL reservation record.
HttpServiceConfigTimeout
 Sets a specified HTTP Server API wide connection time-out.

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

Windows 8 and later:  This enumeration value is supported.
HttpServiceConfigSslCcsCertInfo
 Sets 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.

-param pConfigInformation [in]

A pointer to a buffer that contains the appropriate data to specify the type of record to be set.

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

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

-param ConfigInformationLength [in]

Size, in bytes, of the pConfigInformation buffer.

-param pOverlapped [in]

This parameter is reserved and must be NULL.

-returns

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Meaning
ERROR_ALREADY_EXISTS
 The specified record already exists, and must be deleted in order for its value to be re-set.
ERROR_INSUFFICIENT_BUFFER
 The buffer size specified in the ConfigInformationLength parameter is insufficient.
ERROR_INVALID_HANDLE
 The ServiceHandle parameter is invalid.
ERROR_INVALID_PARAMETER
 One or more of the supplied parameters is in an unusable form.
ERROR_NO_SUCH_LOGON_SESSION
 The SSL Certificate used is invalid. This can occur only if the HttpServiceConfigSSLCertInfo parameter is used.
Other
 A system error code defined in WinError.h.

-remarks

The configuration parameters set with HttpSetServiceConfiguration are applied to all the HTTP Server API applications on the machine, and persist when the HTTP Server API shuts down, or when the computer is restarted.

-see-also

HTTP Server API Version 1.0 Functions

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration