Функция 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.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Вызывающее приложение не вызывало 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 |