CHttpConnection::OpenRequest

Статья
06/10/2015

Данный функцию-член для открытия подключения HTTP.

CHttpFile* OpenRequest(
   LPCTSTR pstrVerb,
   LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);
CHttpFile* OpenRequest(
   int nVerb,
  LPCTSTR pstrObjectName,
   LPCTSTR pstrReferer = NULL,
   DWORD_PTR dwContext = 1,
   LPCTSTR* ppstrAcceptTypes = NULL,
   LPCTSTR pstrVersion = NULL,
   DWORD dwFlags = INTERNET_FLAG_EXISTING_CONNECT 
);

Параметры

pstrVerb
Указатель на строку, содержащая команду для использования в запросе. Если NULL, ПОЛУЧАЕТ «».
pstrObjectName
Указатель на строку, содержащую целевой объект указанной команды. Обычно это имя файла, исполняемый модуль, или описатель поиска.
pstrReferer
Указатель на строку, которая указывает адрес (URL-адрес) документа, из которого было получено URL-адреса в запросе (pstrObjectName). Если NULL не указано, заголовок HTTP.
dwContext
Идентификатор контекста для операции OpenRequest. В разделе комментария дополнительные сведения о dwContext.
ppstrAcceptTypes
Указатель на массив указателей завершенному объединения LPCTSTR в строки, указывающее типы содержимого, производимых клиентом. Если ppstrAcceptTypes имеет значение NULL, то для интерпретации серверов, что клиент принимает только документы типа «text/*» (то есть только текстовые документы, изображения и не или других двоичных файлов). Тип содержимого эквивалентен переменной CONTENT_TYPE CGI, определяющая тип данных для запросов, вложили сведения, например HTTP PUT и POST.
pstrVersion
Указатель на строку, определяющий версию HTTP. Если NULL, HTTP/1.0 «».
dwFlags
Любое сочетание флажков INTERNET_ FLAG_*. В разделе комментария описание возможных значений dwFlags.
nVerb
Номер, связанный с типом HTTP-запроса. Может принимать следующие значения:

Тип HTTP-запроса

Значение nVerb

HTTP_VERB_POST

0

HTTP_VERB_GET

1

HTTP_VERB_HEAD

2

HTTP_VERB_PUT

3

HTTP_VERB_LINK

4

HTTP_VERB_DELETE

5

HTTP_VERB_UNLINK

6

Тип HTTP-запроса	Значение nVerb
HTTP_VERB_POST	0
HTTP_VERB_GET	1
HTTP_VERB_HEAD	2
HTTP_VERB_PUT	3
HTTP_VERB_LINK	4
HTTP_VERB_DELETE	5
HTTP_VERB_UNLINK	6

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

Указатель на спрошенному объект CHttpFile.

Заметки

dwFlags может принимать следующие значения:

Флажок Интернета	Описание
INTERNET_FLAG_RELOAD	Контролирует число запрошенного объекта, файла или каталога из списка сервера-источника, а не из кэша.
INTERNET_FLAG_DONT_CACHE	Добавляет сущность не возвращается в кэш.
INTERNET_FLAG_MAKE_PERSISTENT	Добавляет сущность возвращается в кэш как упорная сущность. Это означает, что для кэширования очистка, проверку целостности, или сборка мусора не может удалить этот элемент из кэша.
INTERNET_FLAG_SECURE	Используется безопасная семантику транзакции. Это переходит к использованию SSL/PCT и учитывается только в HTTP-запросе
INTERNET_FLAG_NO_AUTO_REDIRECT	Используется только с HTTP, указывает, что перенаправления не будут автоматически обрабатываться в CHttpFile::SendRequest.

Переопределите по умолчанию dwContext, чтобы задать идентификатор контекста значение для выбора. Идентификатор контекста связан с конкретной операции объекта CHttpConnection, созданного с объектом CInternetSession. Значение возвращается в CInternetSession::OnStatusCallback, чтобы задать состояние операции, в которой она определена. См. статью Первые шаги в интернете. WinInet для получения дополнительных сведений о идентификатору контекста.

Исключения могут быть созданы с помощью этой функции.