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


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

Функция HttpCreateHttpHandle создает очередь HTTP-запросов для вызывающего приложения и возвращает ей дескриптор.

Начиная с API HTTP-сервера версии 2.0, приложения должны вызывать HttpCreateRequestQueue для создания очереди запросов; Не следует использовать HttpCreateHttpHandle .

Синтаксис

HTTPAPI_LINKAGE ULONG HttpCreateHttpHandle(
  [out] PHANDLE RequestQueueHandle,
  [in]  ULONG   Reserved
);

Параметры

[out] RequestQueueHandle

Указатель на переменную, которая получает дескриптор очереди запросов.

[in] Reserved

Зарезервировано. Этот параметр должен быть равен нулю.

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

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

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

Значение Значение
ERROR_DLL_INIT_FAILED
Вызывающее приложение не вызывало HttpInitialize перед вызовом этой функции.
Другое
Код системной ошибки, определенный в WinError.h.

Комментарии

Очередь запросов позволяет вызывающей приложению получать запросы по определенным URL-адресам. Вызывающее приложение использует функцию HttpAddUrl для указания URL-адреса, по которому оно должно получать запросы.

Приложение должно использовать одну очередь запросов для получения запросов. Использование нескольких очередей запросов из одного процесса не увеличивает время отклика или пропускную способность.

Когда приложение завершит получение запросов, оно должно вызвать функцию CloseHandle , чтобы закрыть дескриптор.

Требования

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

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

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

HttpAddUrl

HttpCreateRequestQueue