Интерфейс 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 |
|
| Библиотека |
|
| DLL |
|