CHttpFile::AddRequestHeaders

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 );

返回值:
如果成功,则返回非零值,否则为0。如果该调用失败,Win32的函数GetLastError 会被调用,确定失败的原因。

参数:
pstrHeaders一个指向某字符串的指针,该字符串包含添加到请求中的头。每个头都必须以CR/LF结束。
dwFlags修改新头部的语义。可能为以下几种之一:
·HTTP_ADDREQ_FLAG_COALESCE利用标记来添加后续头部的第一个头部,从而合并相同名字的头部。例如,“Accept:audio/*”后的“Accept: text/*”导致形成一个唯一的头部“Accept:text/*,audio/*”。考虑到从与合并或独立头一起发送的请求中收到的数据,要靠调用应用来保证一个有内聚力的体制。
·HTTP_ADDREQ_FLAG_REPLACE执行移动和添加,替换当前头。头名称将被用于移动当前头,全值将被用于添加新头。如果头部值为空且头已被找到,则移走它。如果不为空,则头值被替换。
·HTTP_ADDREQ_FLAG_ADD_IF_NEW如果不存在,则只需添加头;如果有一个存在,则出错返回。
·HTTP_ADDREQ_FLAG_ADD与REPLACE一起使用。如果不存在,则添加头。
dwHeadersLenpstrHeaders的长度,以字符计算。如果为-1L,则pstrHeaders被假定为是空终止的,且长度已被计算出来了。
str一个CString对象的参考,包含请求头或者将被添加的头。

说明:
调用该成员函数,用来对HTTP请求操作添加一个或多个请求头。AddRequestHeaders 增加附加的、形式自由的头到HTTP请求操作中。其往往被高级客户使用,他们需要对发往HTTP服务器的指定的请求进行具体控制。
注意:
对于使用HTTP_ADDREQ_FLAG_ADD或者HTTP_ADDREQ_FLAG_ADD_IF_NEW对AddRequestHeaders的调用,应用可在pstrHeaders 或str中,一次传递多个头。如果应用试图使用HTTP_ADDREQ_FLAG_REMOVE或HTTP_ADDREQ _FLAG_REPLACE来移动或替换一个头,则lpszHeaders中只能提供一个头。

请参阅:CInternetFile