CHttpFile类

调用该成员函数，用来对HTTP请求操作添加一个或多个请求头。AddRequestHeaders 增加附加的、形式自由的头到HTTP请求操作中。其往往被高级客户使用，他们需要对发往HTTP服务器的指定的请求进行具体控制。

目录

1CHttpFile

2返回值：

1CHttpFile

提供向HTTP服务器中请求和读取的功能。

如果Internet会话要从一个HTTP服务器中读取数据，则必须构造一个CHttpFile实例。

#include <afxinet.h>

CHttpFile类的成员

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 会被调用，确定失败的原因。2返回值：

说明：

注意：

对于使用HTTP_ADDREQ_FLAG_ADD或者HTTP_ADDREQ_FLAG_ADD_IF_NEW对AddRequestHeaders的调用，应用可在pstrHeaders 或str中，一次传递多个头。如果应用试图使用HTTP_ADDREQ_FLAG_REMOVE或HTTP_ADDREQ _FLAG_REPLACE来移动或替换一个头，则lpszHeaders中只能提供一个头。

CHttpFile::CHttpFile

CHttpFile( HINTERNET hFile, HINTERNET hSession, LPCTSTR pstrObject, LPCTSTR pstrServer, LPCTSTR pstrVerb, DWORD dwContext );

CHttpFile( HINTERNET hFile, LPCTSTR pstrVerb, LPCTSTR pstrObject,  CHttpConnection* pConnection );

说明：

调用该成员函数来构造一个CHttpFile对象。

不能直接构造一个CHttpFile对象，但可以调用CInternetSession::OpenURL 或 CHttpConnection::OpenRequest。

CHttpFile::Close

virtual void Close( );

说明：

关闭CHttpFile 并释放其资源。只有在对SendRequest的成功调用或者一个CHttpFile对象被 OpenURL成功创建后，才能使用该成员函数。

CHttpFile::EndRequest

BOOL EndRequest(DWORD dwFlags = 0, LPINTERNET_BUFFERS lpBuffln = NULL, DWORD dwContext = 1);

throw( CInternetException);

说明：

调用此成员函数来结束用成员函数发送HTTP服务器的请求。

返回值：

一个CString对象，包含一个参照与本文件相关联资源的URL。

说明：

调用该成员函数，得到以URL表示的HTTP文件的名字。

CHttpFile::GetObject

CString GetObject( ) const;

返回值：一个包含对象名称的CString对象。

说明：

调用该成员函数以了解与此CHttpFile相关联的对象名称。

CHttpFile::GetVerb

CString GetVerb( ) const;

返回值：一个包含HTTP动词名的CString对象。

调用该成员函数以了解与此CHttpFile相关联的HTTP动词。

CHttpFile:: QueryInfo

BOOL  QueryInfo( DWORD dwInfoLevel, LPVOID lpvBuffer, LPDWORD lpdwBufferLength, LPDWORD lpdwIndex = NULL ) const;

BOOL  QueryInfo( DWORD dwInfoLevel, CString& str, LPDWORD dwIndex = NULL) const;

BOOL  QueryInfo( DWORD dwInfoLevel, SYSTEMTIME* pSysTime, LPDWORD dwIndex = NULL ) const;

调用此成员函数返回HTTP请求中的回答或请求头。只有在SendRequest被成功调用或者一个CHttpFile对象被 OpenURL成功创建后，才能使用该成员函数。

你可从 QueryInfo中获取以下数据类型：

当一个字符串被写入缓冲区，且成员函数成功时，lpdwBufferLength 包含字符串的字节长减一，去掉结束NULL字符的长度。

可能的dwInfoLevel值包括：

CHttpFile::QueryInfoStatusCode

BOOL QueryInfoStatusCode( DWORD& dwStatusCode ) const;

调用此成员函数以获得HTTP请求相关联的状态号并将其放到所提供的dwStatusCode 参数中。

分组的HTTP 状态号标识请求的成功或失败。以下列表列出了状态号组及大部分常用状态号。

分组	含义
200-299	成功
300-399	信息
400-499	请求错误
500-599	服务器错误

常用的HTTP状态号：

状态号	含义
200	URL定位，接着传输
400	不可理解的请求
404	所请求的URL未找到
405	服务器不支持所请求的方法
500	未知的服务器错误
503	已达到服务器容量

CHttpFile::SendRequest

BOOL SendRequest( LPCTSTR pstrHeaders = NULL, DWORD dwHeadersLen = 0, LPVOID lpOptional = NULL, DWORD dwOptionalLen= 0 );

throw(CInternetException);

BOOL SendRequest( CString& strHeaders, LPVOID lpOptional = NULL, DWORD dwOptionalLen = 0 );

throw(CInternetException);

参数：

说明：调用此成员函数以向HTTP服务器发送请求。

CHttpFile::SendRequestEx

BOOL SendRequestEx(DWORD dwTotalLen, DWORD dwFlags = HSR_INITIATE, DWORD dwContext = 1);

throw(CInternetException);

BOOL SendRequestEx(LPINTERNET_BUFFERS lpBuffIn, LPINTERNET_BUFFERS lpBuffOut, DWORD dwFlags = HSR_INITIATE, DWORD dwContext = 1);

throw(CInternetException);

返回值：

如果成功，则返回非零值，否则为0。如果此调用失败，可通过检查产生的CInternetException对象来确定错误原因。

参数：

说明：

调用此成员函数来向一个HTTP 服务器发送请求。此函数允许应用使用 CInternetFile的Write和WriteString 来发送数据。在调用任一此函数的覆盖前，必须知道发送的数据长度。第一个覆盖允许确定你要发送的数据长度。第二个覆盖接收指向INTERNET_BUFFERS结构的 指针，它可以用来详细地描述缓冲区。

当内容已被写入文件时，调用EndRequest来结束此操作。

dwContext的缺省值由MFC从创建此CHttpFile对象的CInternetSession对象发送到CHttpFile对象。当调用CInternetSession::OpenURL 或CHttpConnection 来构造一个CHttpFile对象时，可覆盖此缺省值，来设置你所选择的值的上下文标识符。上下文标识符返回到CInternetSession::OnStatusCallback ，提供其所代表的对象状态。请参阅联机文档“Visual C++程序员指南”中的“Internet初步：WinInet”，以了解有关上下文标识符的更多信息。

示例：

此 代码段发送一个字符串的内容到名为ISAPI的DLL 中，DLL在服务器中为MOOSEBOY。此示例对WriteString的调用只有一个，但可以使用多个来发送成块数据。

CString strData = "Some very long data to be POSTed here!";

pServer = sess.GetHttpConnection("mooseboy");

pFile = pServer->OpenRequest( CHttpConnection::HTTP_VERB_POST, "/isapi.dll?");

pFile->SendRequestEx(strData.GetLength());

pFile->WriteString(strData);

pFile->EndRequest();