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

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

  • Статья

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

Синтаксис

HTTPAPI_LINKAGE ULONG HttpInitialize(
  [in]      HTTPAPI_VERSION Version,
  [in]      ULONG           Flags,
  [in, out] PVOID           pReserved
);

Параметры

[in] Version

Версия HTTP. Этот параметр является структурой HTTPAPI_VERSION . Для текущей версии объявите экземпляр структуры и присвойте ему предварительно определенное значение , HTTPAPI_VERSION_1 перед передачей в HttpInitialize.

[in] Flags

Параметры инициализации, которые могут включать одно или оба следующих значения.

Значение Значение
HTTP_INITIALIZE_CONFIG
 Выполните инициализацию для приложений, использующих функции конфигурации HTTP, HttpSetServiceConfiguration, HttpQueryServiceConfiguration, HttpDeleteServiceConfiguration и HttpIsFeatureSupported.
HTTP_INITIALIZE_SERVER
 Выполните инициализацию для приложений, использующих API HTTP-сервера.

[in, out] pReserved

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

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

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

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

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

Комментарии

Вызовите HttpTerminate после завершения работы приложения. Все те же флаги, которые были переданы в HttpInitialize в параметре Flags , также должны быть переданы в HttpTerminate. Приложение может многократно вызывать HttpInitialize при условии, что каждый вызов HttpInitialize позже сопоставляется соответствующим вызовом HttpTerminate.

Требования

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

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