CHttpFile::AddRequestHeaders

Статья
06/10/2015

Эта функция-член вызывается для добавления одного или несколько заголовков HTTP-запросов к маркеру HTTP-запроса.

BOOL AddRequestHeaders( 
   LPCTSTR pstrHeaders, 
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW, 
   int dwHeadersLen = -1  
); 
BOOL AddRequestHeaders( 
   CString& str, 
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW  
);

Параметры

pstrHeaders
Указатель на строку, содержащую заголовок или заголовки, добавляемые к запросу. Каждый заголовок должен быть завершен ключом CR/LF.
dwFlags
Изменяет семантику новых заголовков. Может принимать следующие значения:
- Слияние HTTP_ADDREQ_FLAG_COALESCE заголовки с тем же именем, используя пометить, чтобы добавить первый найденный заголовка к последующему заголовок. Например, "принять вариант: text/*" и "accept. audio/*" результаты "в образовании одного заголовка accept. text/*, audio/*". Он до вызывающего приложения предоставить кохезионную схему по отношению к данным, полученным с запросами, отправленными целочисленный или разделить заголовки.
- HTTP_ADDREQ_FLAG_REPLACE выполняет удаление и добавление для замены текущего заголовок. Имя заголовка будет использоваться для удаления текущий заголовок, а полное значение будет использоваться для добавления нового заголовка. Если заголовок- значение пусто и заголовок найти, он удаляется. Если не пустой, заголовок-значение заменено.
- HTTP_ADDREQ_FLAG_ADD_IF_NEW только добавляет заголовок (если он еще не существует. Если таковой существует, возвращается ошибка.
- HTTP_ADDREQ_FLAG_ADD, используемый с ЗАМЕНЯЕТ. Добавляет заголовок, если он не существует.
dwHeadersLen
Длина в символах pstrHeaders. Если это -1L, то предполагается, что нулевой- завершено pstrHeaders и длина вычисляется.
str
Ссылка на объект CString, содержащая заголовок запроса или заголовки для добавления.

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

Ненулевой, если успешно; в противном случае – значение 0. Если вызов завершается с ошибкой, то функция Win32 GetLastError может быть называется, чтобы определить причину ошибки.

Заметки

AddRequestHeaders добавляет дополнительные заголовки свободен- формата к маркеру HTTP-запроса. Предназначено для использования изощренными клиентами, которым необходим подробный элемент управления с явным запросом, посылаемым на сервер HTTP.

Примечание

Приложение может передавать несколько заголовков в pstrHeaders или str для вызова AddRequestHeaders с помощью HTTP_ADDREQ_FLAG_ADD или HTTP_ADDREQ_FLAG_ADD_IF_NEW.Если приложение пытается удалить или заменить заголовок с помощью HTTP_ADDREQ_FLAG_REMOVE или HTTP_ADDREQ_FLAG_REPLACE только один заголовок может быть передано в lpszHeaders.

Требования

Header: afxinet.h

См. также

Ссылки

Класс CHttpFile

Диаграмма иерархии

Класс CInternetFile

Поделиться через