通过

CHttpFile::AddRequestHeaders

  • 项目

调用此成员函数添加一个或多个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/*”后跟“接受:audio/*”那个标头的窗体的结果“接受:text/*，audio/*”。将由调用应用程序确保一个言词一致的模式有关请求收到的数据发送的联合或分隔标头。

    • HTTP_ADDREQ_FLAG_REPLACE 执行一移除并添加替换当前标头。标头名称将用于移除当前标头，这样，个完整的值将用于添加新标头。如果该标头值为null，而且找到该标头，请将其删除。如果不为空，则标头值将替换。

    • 如果它已不存在，HTTP_ADDREQ_FLAG_ADD_IF_NEW 只将该标头。如果存在，则会返回错误。

    • HTTP_ADDREQ_FLAG_ADD 使用了替换。如果不存在，则将该标头。

  • dwHeadersLen
    长度，在字符，pstrHeaders。如果这是-1L，则 pstrHeaders 假定零结尾，并且该长度计算。

  • str
    对包含请求标头或标头的 CString 对象的引用将添加。

返回值

非零，如果成功;否则为0。如果调用失败，Win32函数 GetLastError 可以调用以确定导致错误的原因。

备注

AddRequestHeaders 追加此外，对HTTP请求的处理的任意格式标头。供需要对确切的请求进行精确控制发送到HTTP服务器的复杂的客户端使用。

说明说明

应用程序可以通过在 pstrHeaders 的多个标头或 AddRequestHeaders 的 str 调用使用 HTTP_ADDREQ_FLAG_ADD 或 HTTP_ADDREQ_FLAG_ADD_IF_NEW。使用 HTTP_ADDREQ_FLAG_REMOVE 或 HTTP_ADDREQ_FLAG_REPLACE，如果应用程序尝试移除或替换标头，因此，只有一个标头在 lpszHeaders可在中提供。

要求

Header: afxinet.h

请参见

参考

CHttpFile选件类

层次结构图

CInternetFile选件类