Объект 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);
    }

Примеры кода, взятые из Свойства ивинхттпрекуест:: Status.

Элементы

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

События

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

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

Методы

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

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

Элемент Property

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

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

Remarks

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

Примечание

сведения о Windows XP и Windows 2000 см. в разделе требования к времени выполнения.

Требования

Требование Значение
Минимальная версия клиента
Windows XP, Windows 2000 Professional с SP3 [ только для настольных приложений]
Минимальная версия сервера
Windows сервер 2003, Windows 2000 server с пакетом обновления 3 (SP3), [ только классические приложения]
Распространяемые компоненты
WinHTTP 5,0 и Internet Explorer 5,01 или более поздней версии в Windows XP и Windows 2000.
IDL
HttpRequest. idl
Библиотека
WinHTTP. lib
DLL
Winhttp.dll

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

Версии WinHTTP