Объект 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 |
|
| Библиотека |
|
| DLL |
|