CInternetSessio和CFtpConnection连接FTP

要联接到FTP服务器，需要两个步骤，首先必须创建一个CInternetSession对象，用类CInterSession创建并初始化一个或几个同时存在的Internet会话(session)，并描述与代理服务器的连接（如果有必要的话），如果在程序运行期间需要保持与Internet的连接，可以创建一个CInternetSession对象作为类CWinApp的成员。 

MFC中的类CFtpConnection管理我们与Internet服务器的连接，并直接操作服务器上的目录和文件，FTP是MFC的WinInet支持的三个Internet功能之一，我们需要先创建一个CInternetSession实例和一个CFtpConnection对象就可以实现和一个FTP服务器的通信，我们不需要直接创建CFtpConnection对象，而是通过调用CInternetSession::GetFtpConnection来完成这项工作。它创建CFtpConnection对象并返回一个指向该对象的指针。 

Ftp连接类的信息 

下面我们简要介绍连接类的信息 

CInternetSession对象 
CInternetSession(LPCTSTR pstrAgent,DWORD dwConText ,DWORD dwAccessType,LPCTSTR pstrProxyName,LPCTSTR pstrProxyBypass,DWORD dwFlags); 

在创建CInternetSession对象时调用这个成员函数，CInternetSession是应用程序第一个要调用的Internet函数，它将创始化内部数据结构，以备将来在应用程序中调用。如果dwFlags包含INTERNET_FLAG_ASYNC,那末从这个句柄派生的所有的句柄，在状态回调例程注冊之前，都会出现异步状态。如果沒有打开Internet连接，CInternetSession就会抛出一个例外，AfxThorowInternetException。 


GetFtpConnection()函数 
CFtpConnection* CIternetSession::GetFtpConnection(LPCTSTR pstrServer,LPCTSTR pstrUserName,LPCTSTR pstrPassword,INTERNET_PORT nPort,BOOL bPassive); 

调用这个函数建立一个FTP连接，并获得一个指向CFtpConnection对象的指针，GetFtpConnection连接到一个FTP服务器，创建并返回指向CFtpConnection对象的指针，它不在服务器上进行任何操作。如果打算读写文件，必须进行分步操作。关于查找，打开和读／写文件的信息需参考CFtpConnection和CFtpFileFind类。 

对这个函数的调用返回一个指向CFtpConnection对象的指针。如果调用失败，检查抛出的CInternetException对象，就可以确定失败的原因。 


GetFile()函数 
BOOL GetFile(LPCTSTR pstrRemoteFile,LPCTSTR pstrLocalFile,BOOL bFailExists ,DWORD dwAttributes,DWORD dwFlags,DWORD dwContext); 

调用这个成员函数，可以从FTP服务器取得文件，并且把文件保存在本地机器上。GetFile()函数是一个比较高级的例程，它可以处理所有有关从FTP服务器读文件，以及把文件存放在本地机器上的工作。如果dwFlags为FILE_TRANSFER_TYPE_ASCII,文件数据的传输也会把控制和格式符转化为Windows中的等阶符号。默认的传输模式是二进制模式，文件会以和服务器上相同的格式被下载。 

pstrRemoteFile和 pstrLocalFile可以是相对于当前目录的部分文件名，也可以是全文件名，在这两个名字中间，都既可以用反斜杠(\)或者正斜杠(/)来作为文件名的目录分隔符，GetFile()在使用前会把目录分隔符转化为适当的字符。 

可以用自己选择的值来取代dwContext默认的值，设置为上下文标识符与CFtpConnection对象的定位操作有关，这个操作由CFtpConnection中的CInternetSession对象创建。返回给CInternetSession::OnStatusCallBack的值指出了所标识操作的状态。 

如果调用成功，函数的返回为非0,否则返回0，如果调用失败，可以调用Win32函数GetLastError(),确认出错的原因。 


PutFile()函数 
BOOL PutFile(LPCTSTR pstrLocalFile, LPCTSTR pstrRemoveFile ,DWORD dwFlags, DWORD dwContext); 

调用这个成员函数可以把文件保存到FTP服务器。PutFile()函数是一个比较高级的例程，它可以处理有关把文件存放到服务器上的工作。只发送数据，或要严格控制文件传输的应用程序，应该调用OpenFile和 CInternet::Write。利用自己选择的值来取代dwContext默认的值，设置为上下文标识符，上下文标识符是CInternetSession对象创建的CFtpConnection对象的特定操作有关，这个值返回给CInternetSession::OnStateCallBack,从而把操作的状态通报给它所标识的上下文。 

如果调用成功，函数的返回为非0,否则返回0，如果调用失败，可以调用Win32函数GetLastError(),确认出错的原因。 

 

下面这个函数是我写的一个例子。供参考

/************************************************************************/
/*
参数说明:
 FtpPath   要下载的ftp 目录或文件
 localPath    保存到本地的目录
 ftpAdd       ftp地址
 ftpSuser　　　登陆ftp的用户名
 ftpPass       登陆ftp的密码
 sErr          发生错误时，返回的错误信息*/
                                                       
/************************************************************************/
BOOL GetFileFromFTP( CString FtpPath, CString LocalPath ,CString ftpAdd, CString ftpUser, CString ftpPass, CString &sErr )
{
 CString sTemp ;
 CString sLocalTemp ;
 CString sTempFtpPath ;
 CInternetSession  pInternetCon(AfxGetAppName(),1,PRE_CONFIG_INTERNET_ACCESS);
 CFtpConnection *pFtpCon ;
 try
 {
  pFtpCon =pInternetCon.GetFtpConnection( ftpAdd, ftpUser, ftpPass, 21 );
  if ( pFtpCon != NULL)
  {
   CFtpFileFind FtpFinder( pFtpCon ) ;
   BOOL bWork = FtpFinder.FindFile( FtpPath );
   while ( bWork )
   {
    bWork = FtpFinder.FindNextFile() ;
    if ( FtpFinder.IsDots() )
     continue;
    if(FtpFinder.IsDirectory() )
    {  //是目录
     sTemp.Empty() ;
     sTemp = FtpFinder.GetFileName() ;
     sTempFtpPath.Empty() ;
     sTempFtpPath = FtpPath.Left( FtpPath.GetLength() - 3 )  ;
     sTempFtpPath += sTemp + "//*.*" ;
     sLocalTemp.Empty() ;
     sLocalTemp = LocalPath + "\\" + sTemp ;
     CFileStatus   rStatus;
     if( !( CFile::GetStatus( sLocalTemp, rStatus ) ) )
     {//文件夹不存在, 创建之
      if( !(CreateDirectory((LPCTSTR)sLocalTemp, NULL)) )
      {//创建失败
       DWORD dErr = GetLastError() ;
       sErr.Format( "创建新目录失败: ERROR  %d" ,dErr ) ;
       return FALSE ; 
      }
     }
     GetFileFromFTP( sTempFtpPath, sLocalTemp, ftpAdd, ftpUser, ftpPass, sErr ) ;
    }
    else
    {
     sTemp.Empty() ;
     sTemp = FtpFinder.GetFileName();
     sLocalTemp.Empty() ;
     sLocalTemp = LocalPath + "\\" + sTemp ;
     sTemp.Empty() ;
     sTemp = FtpFinder.GetFilePath();//
     CFileStatus   rStatus;
     if( !( CFile::GetStatus( sLocalTemp, rStatus ) ) )
     {//文件不存在，下载之
      if( !( pFtpCon->GetFile( sTemp, sLocalTemp, true, FILE_ATTRIBUTE_NORMAL, FTP_TRANSFER_TYPE_BINARY, 1) ) )
      {//下载失败
       DWORD dErr = GetLastError() ;
       sErr.Format( "下载失败: ERROR  %d" ,dErr ) ;
       return FALSE ;
      } 
     }
    }
   }
   FtpFinder.Close() ;
      }      
 }
 catch (CInternetException * pEx)
 {
  TCHAR szError[1024];
  pEx->GetErrorMessage(szError,1024) ;
  sErr.Format( "连接FTP失败:%s", pEx ) ;
  pEx->Delete();
  pFtpCon=NULL;
  return FALSE ;
 }
 return TRUE ;
}