Функция HttpSetServiceConfiguration (http.h)

Функция HttpSetServiceConfiguration создает и задает запись конфигурации для хранилища конфигурации API HTTP-сервера. Вызов завершается ошибкой, если указанная запись уже существует. Чтобы изменить заданную запись конфигурации, удалите ее и повторно создайте ее с другим значением.

Синтаксис

HTTPAPI_LINKAGE ULONG HttpSetServiceConfiguration(
  [in] HANDLE                 ServiceHandle,
  [in] HTTP_SERVICE_CONFIG_ID ConfigId,
  [in] PVOID                  pConfigInformation,
  [in] ULONG                  ConfigInformationLength,
  [in] LPOVERLAPPED           pOverlapped
);

Параметры

[in] ServiceHandle

Зарезервировано. Должно быть равно нулю.

[in] ConfigId

Тип записи конфигурации для задания. Этот параметр может быть одним из следующих значений из перечисления HTTP_SERVICE_CONFIG_ID .

Значение ConfigId	Meaning
HttpServiceConfigIPListenList	Задает запись в списке прослушивания IP-адресов.
HttpServiceConfigSSLCertInfo	Задает указанную запись SSL-сертификата.
HttpServiceConfigUrlAclInfo	Задает запись резервирования URL-адресов.
HttpServiceConfigTimeout	Задает указанное время ожидания времени ожидания подключения API HTTP-сервера. Windows Vista и более поздние версии: Это значение перечисления поддерживается.
HttpServiceConfigSslSniCertInfo	Задает указанную запись сертификата имени SSL-сервера (SNI). Windows 8 и более поздних версий: Это значение перечисления поддерживается.
HttpServiceConfigSslCcsCertInfo	Задает запись SSL-сертификата, указывающую, что Http.sys следует обратиться к хранилищу централизованного хранилища сертификатов (CCS), чтобы найти сертификаты, если порт получает подтверждение tls. Порт задается членом KeyDesc структуры HTTP_SERVICE_CONFIG_SSL_CCS_SET , передаваемой в параметр pConfigInformation . Windows 8 и более поздних версий: Это значение перечисления поддерживается.

[in] pConfigInformation

Указатель на буфер, содержащий соответствующие данные, чтобы указать тип записи, которую необходимо задать.

Значение ConfigId	Meaning
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM структура.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET структура.
HttpServiceConfigUrlAclInfo	структура HTTP_SERVICE_CONFIG_URLACL_SET .
HttpServiceConfigTimeout	HTTP_SERVICE_CONFIG_TIMEOUT_SET структура. Windows Vista и более поздние версии: Эта структура поддерживается.
HttpServiceConfigSslSniCertInfo	HTTP_SERVICE_CONFIG_SSL_SNI_SET структуре. Имя узла будет "*", если центральное хранилище сертификатов SSL запрашивается и используются подстановочные знаки, а также имя узла для регулярного SNI. Windows 8 и более поздних версий: Эта структура поддерживается.
HttpServiceConfigSslCcsCertInfo	HTTP_SERVICE_CONFIG_SSL_CCS_SET структура. Windows 8 и более поздних версий: Эта структура поддерживается.

[in] ConfigInformationLength

Размер в байтах буфера pConfigInformation .

[in] pOverlapped

Этот параметр зарезервирован и должен иметь значение NULL.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение NO_ERROR.

Если функция завершается ошибкой, возвращаемое значение является одним из следующих кодов ошибок.

Ценность	Meaning
ERROR_ALREADY_EXISTS	Указанная запись уже существует и должна быть удалена, чтобы ее значение было повторно задано.
ERROR_INSUFFICIENT_BUFFER	Размер буфера, указанный в параметре ConfigInformationLength , недостаточно.
ERROR_INVALID_HANDLE	Недопустимый параметр ServiceHandle .
ERROR_INVALID_PARAMETER	Один или несколько указанных параметров находится в неиспользуемой форме.
ERROR_NO_SUCH_LOGON_SESSION	Используемый SSL-сертификат недопустим. Это может произойти только в том случае, если используется параметр HttpServiceConfigSLCertInfo .
Другое	Системный код ошибки, определенный в WinError.h.

Замечания

Параметры конфигурации с httpSetServiceConfiguration применяются ко всем приложениям API HTTP-сервера на компьютере и сохраняются при завершении работы API HTTP-сервера или при перезапуске компьютера.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
Header	http.h
Library	Httpapi.lib
DLL	Httpapi.dll

См. также

Функции API HTTP Server версии 1.0

HttpDeleteServiceConfiguration

HttpQueryServiceConfiguration

HttpUpdateServiceConfiguration