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


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

Функция 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