Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция 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 |
|---|---|
|
Задает запись в списке прослушивания IP-адресов. |
|
Задает указанную запись SSL-сертификата. |
|
Задает запись резервирования URL-адресов. |
|
Задает указанное время ожидания времени ожидания подключения API HTTP-сервера. Windows Vista и более поздние версии: Это значение перечисления поддерживается. |
|
Задает указанную запись сертификата имени SSL-сервера (SNI).
Windows 8 и более поздних версий: Это значение перечисления поддерживается. |
|
Задает запись SSL-сертификата, указывающую, что Http.sys следует обратиться к хранилищу централизованного хранилища сертификатов (CCS), чтобы найти сертификаты, если порт получает подтверждение tls. Порт задается членом KeyDesc структуры HTTP_SERVICE_CONFIG_SSL_CCS_SET , передаваемой в параметр pConfigInformation .
Windows 8 и более поздних версий: Это значение перечисления поддерживается. |
[in] pConfigInformation
Указатель на буфер, содержащий соответствующие данные, чтобы указать тип записи, которую необходимо задать.
| Значение ConfigId | Meaning |
|---|---|
|
HTTP_SERVICE_CONFIG_IP_LISTEN_PARAM структура. |
|
HTTP_SERVICE_CONFIG_SSL_SET структура. |
|
|
|
HTTP_SERVICE_CONFIG_TIMEOUT_SET структура. Windows Vista и более поздние версии: Эта структура поддерживается. |
|
HTTP_SERVICE_CONFIG_SSL_SNI_SET структуре. Имя узла будет "*", если центральное хранилище сертификатов SSL запрашивается и используются подстановочные знаки, а также имя узла для регулярного SNI. Windows 8 и более поздних версий: Эта структура поддерживается. |
|
HTTP_SERVICE_CONFIG_SSL_CCS_SET структура. Windows 8 и более поздних версий: Эта структура поддерживается. |
[in] ConfigInformationLength
Размер в байтах буфера pConfigInformation .
[in] pOverlapped
Этот параметр зарезервирован и должен иметь значение NULL.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение NO_ERROR.
Если функция завершается ошибкой, возвращаемое значение является одним из следующих кодов ошибок.
| Ценность | Meaning |
|---|---|
|
Указанная запись уже существует и должна быть удалена, чтобы ее значение было повторно задано. |
|
Размер буфера, указанный в параметре ConfigInformationLength , недостаточно. |
|
Недопустимый параметр ServiceHandle . |
|
Один или несколько указанных параметров находится в неиспользуемой форме. |
|
Используемый 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