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

Статья
08/24/2023

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

Share via