Интерфейс IWinHttpRequest

Интерфейс IWinHttpRequest предоставляет все методы nonevent для служб MICROSOFT Windows HTTP (WinHTTP).

Элементы

Интерфейс IWinHttpRequest наследуется от интерфейса IUnknown . IWinHttpRequest также имеет следующие типы членов:

• Методы
• Свойства

Методы

Интерфейс IWinHttpRequest содержит следующие методы.

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

Свойства

Интерфейс IWinHttpRequest имеет следующие свойства.

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

Комментарии

Интерфейс IWinHttpRequest , определенный в httprequest.idl, реализуется классом с идентификатором CLSID_WinHttpRequest. Приложение получает этот интерфейс, вызывая CoCreateInstance с идентификатором класса CLSID_WinHttpRequest и идентификатором интерфейса IID_IWinHttpRequest.

Примечание

Для Windows XP и Windows 2000 см. раздел Требования к времени выполнения начальной страницы WinHttp.

Требования

Требование	Значение
Минимальная версия клиента	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

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

IWinHttpRequestEvents

Версии WinHTTP