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

Статья
08/24/2023

Функция HttpDeleteServiceConfiguration удаляет указанные данные, такие как IP-адреса или SSL-сертификаты, из хранилища конфигурации API HTTP-сервера по одной записи за раз.

Синтаксис

HTTPAPI_LINKAGE ULONG HttpDeleteServiceConfiguration(
  [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	Значение
HttpServiceConfigIPListenList	Удаляет указанный IP-адрес из списка прослушивания IP-адресов.
HttpServiceConfigSSLCertInfo	Удаляет указанную запись SSL-сертификата.
HttpServiceConfigUrlAclInfo	Удаляет указанную запись резервирования URL-адресов.
HttpServiceConfigTimeout	Удаляет указанное время ожидания подключения. 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 .

Значение ConfigId	Значение
HttpServiceConfigIPListenList	HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM структура.
HttpServiceConfigSSLCertInfo	HTTP_SERVICE_CONFIG_SSL_SET структура.
HttpServiceConfigUrlAclInfo	HTTP_SERVICE_CONFIG_URLACL_SET структура.
HttpServiceConfigTimeouts	HTTP_SERVICE_CONFIG_TIMEOUT_KEY структура. 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.

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

Значение	Значение
ERROR_INVALID_PARAMETER	Один из параметров недопустим.
Другое	Код системной ошибки, определенный в WinError.h.

Требования


Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	http.h
Библиотека	Httpapi.lib
DLL	Httpapi.dll

См. также раздел

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

HttpQueryServiceConfiguration

HttpSetServiceConfiguration

HttpUpdateServiceConfiguration

Поделиться через