Функция HttpOpenRequestA (wininet.h)

Создает дескриптор HTTP-запроса.

Синтаксис

HINTERNET HttpOpenRequestA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszVerb,
  [in] LPCSTR    lpszObjectName,
  [in] LPCSTR    lpszVersion,
  [in] LPCSTR    lpszReferrer,
  [in] LPCSTR    *lplpszAcceptTypes,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Параметры

[in] hConnect

Дескриптор http-сеанса, возвращенного InternetConnect.

[in] lpszVerb

Указатель на строку, завершающуюся значением NULL, которая содержит HTTP-команду, используемую в запросе. Если этот параметр имеет значение NULL, функция использует GET в качестве HTTP-команды.

[in] lpszObjectName

Указатель на строку, завершающуюся null, которая содержит имя целевого объекта указанной HTTP-команды. Обычно это имя файла, исполняемый модуль или описатель поиска.

[in] lpszVersion

Указатель на строку, завершающуюся значением NULL, которая содержит версию HTTP, используемую в запросе. Параметры в Обозреватель Интернета переопределяют значение, указанное в этом параметре.

Если этот параметр имеет значение NULL, функция использует версию HTTP 1.1 или 1.0 в зависимости от значения параметров internet Обозреватель.

[in] lpszReferrer

Указатель на строку, завершающуюся значением NULL, которая указывает URL-адрес документа, из которого был получен URL-адрес в запросе (lpszObjectName). Если этот параметр имеет значение NULL, ссылочный объект не указан.

[in] lplpszAcceptTypes

Указатель на массив строк со значением NULL, указывающий типы мультимедиа, принятые клиентом. Ниже приведен пример.

PCTSTR rgpszAcceptTypes[] = {_T("text/*"), NULL};

Неправильное завершение массива с помощью указателя NULL приведет к сбою.

Если этот параметр имеет значение NULL, клиент не принимает типы. Серверы обычно интерпретируют отсутствие типов accept, чтобы указать, что клиент принимает только документы типа "text/*" (то есть только текстовые документы — без изображений или других двоичных файлов).

[in] dwFlags

Параметры браузера. Этот параметр может быть любым из следующих значений.

[in] dwContext

Указатель на переменную, содержащую определяемое приложением значение, которое связывает эту операцию с любыми данными приложения.

Возвращаемое значение

Возвращает дескриптор HTTP-запроса в случае успешного выполнения или значение NULL в противном случае. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

Функция HttpOpenRequest создает новый дескриптор HTTP-запроса и сохраняет указанные параметры в этом дескрипторе. Дескриптор HTTP-запроса содержит запрос, отправляемый на HTTP-сервер, и содержит все заголовки RFC822/MIME/HTTP, отправляемые как часть запроса.

Если указан глагол, отличный от GET или POST, HttpOpenRequest автоматически задает INTERNET_FLAG_NO_CACHE_WRITE и INTERNET_FLAG_RELOAD для запроса.

При использовании Microsoft Internet Обозреватель 5 и более поздних версий, если для параметра lpszVerb задано значение "HEAD", заголовок Content-Length игнорируется в ответах от серверов HTTP/1.1.

В Windows 7, Windows Server 2008 R2 и более поздних версиях параметр lpszVersion переопределяется параметрами internet Обозреватель. EnableHttp1_1 — это значение реестра hKLM\Software\Microsoft\InternetExplorer\AdvacnedOptions\HTTP\GENABLE, управляемое параметрами браузера, установленными в Обозреватель Интернета для системы. Значение EnableHttp1_1 по умолчанию равно 1. Функция HttpOpenRequest обновляет любую версию HTTP меньше 1.1 до ВЕРСИИ HTTP 1.1, если EnableHttp1_1 имеет значение 1.

После завершения работы вызывающего приложения с помощью дескриптора HINTERNET , возвращаемого HttpOpenRequest, его необходимо закрыть с помощью функции InternetCloseHandle .

Примечание Если запрос отправляется в асинхронном режиме (параметр dwFlagsinternetOpen указывает INTERNET_FLAG_ASYNC), а параметр dwContext равен нулю (INTERNET_NO_CALLBACK), функция обратного вызова, заданная с параметром InternetSetStatusCallback для дескриптора запроса, не вызывается, однако вызов по-прежнему будет выполняться в асинхронном режиме.

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из DllMain или конструкторов и деструкторов глобальных объектов.

Требования

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

Сеансы HTTP

Функции WinINet