Объект WinHttpRequest

  • Статья

В этом разделе содержатся сведения об использовании COM-объекта WinHTTP WinHttpRequest с языками сценариев. Дополнительные сведения, включая API C++ (WinHTTP), см. в разделе Сведения о WinHTTP. Сравнение этих интерфейсов см. в разделе Выбор интерфейса WinHTTP .

Пример

// Instantiate a WinHttpRequest object.
var WinHttpReq = new ActiveXObject("WinHttp.WinHttpRequest.5.1");

 IWinHttpRequest *  pIWinHttpRequest = NULL;
 \\..
    hr = CLSIDFromProgID(L"WinHttp.WinHttpRequest.5.1", &clsid);

    if (SUCCEEDED(hr))
    {
        hr = CoCreateInstance(clsid, NULL,
                              CLSCTX_INPROC_SERVER,
                              IID_IWinHttpRequest,
                              (void **)&pIWinHttpRequest);
    }

Примеры кода, взятые из свойства IWinHttpRequest::Status.

Элементы

Объект WinHttpRequest имеет следующие типы элементов:

События

Объект WinHttpRequest содержит эти события.

Событие Описание
OnError Происходит при возникновении ошибки во время выполнения в приложении.
OnResponseDataAvailable Происходит, когда данные доступны из ответа.
OnResponseFinished Происходит по завершении обработки ответных данных.
OnResponseStart Происходит при получении ответных данных.

Методы

Объект WinHttpRequest имеет следующие методы.

Метод Описание
Прервать Прерывает методОтправки WinHTTP.
GetAllResponseHeaders Извлекает все заголовки HTTP-ответа.
GetResponseHeader Извлекает заголовки HTTP-ответа.
Open Открывает HTTP-подключение к ресурсу HTTP.
Отправить Отправляет HTTP-запрос на HTTP-сервер.
SetAutoLogonPolicy Задает текущую политику автоматического входа.
SetClientCertificate Выбирает сертификат клиента для отправки на сервер HTTPS.
SetCredentials Задает учетные данные для использования с HTTP-сервером-источником или прокси-сервером.
SetProxy Задает сведения о прокси-сервере.
SetRequestHeader Добавляет, изменяет или удаляет заголовок HTTP-запроса.
SetTimeouts Указывает в миллисекундах отдельные компоненты времени ожидания операции отправки и получения.
WaitForResponse Указывает время ожидания (в секундах) для завершения асинхронного метода Send с необязательным значением времени ожидания.

Свойства

Объект WinHttpRequest имеет следующие свойства.

Свойство Тип доступа Описание
Параметр
 Чтение/запись
 Задает или извлекает значение параметра WinHTTP.
ResponseBody
 Только для чтения
 Извлекает тело сущности ответа в виде массива неподписанных байтов.
ResponseStream
 Только для чтения
 Извлекает тело сущности ответа в виде IStream.
ResponseText
 Только для чтения
 Извлекает текст сущности ответа в виде текста.
Состояние
 Только для чтения
 Извлекает код состояния HTTP из последнего ответа.
StatusText
 Только для чтения
 Извлекает текст состояния HTTP.

Комментарии

Объект WinHttpRequest использует интерфейс IErrorInfo для предоставления данных об ошибках. Описание и числовое значение ошибки можно получить с помощью объекта Err в Microsoft Visual Basic Scripting Edition (VBScript) и объекта Error в Microsoft JScript. Более низкие 16 бит числа ошибок соответствуют значениям, найденным в сообщениях об ошибках.

Примечание

Для Windows XP и Windows 2000 см. статью Требования к времени выполнения.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера
 Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Распространяемые компоненты
 WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000.
IDL
HttpRequest.idl
Библиотека
Winhttp.lib
DLL
Winhttp.dll

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

Версии WinHTTP