CHttpFile::AddRequestHeaders

Статья
02/20/2013

Эта функция-член вызывается для добавления одного или несколько заголовков 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.

Приложение может передавать несколько заголовков в 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

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