笑看風云淡

---- 要聯接到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(),確認出錯的原因。

連接到FTP站點

---- 建立連接到ftp.microsoft.com的程序，它是一個單文檔程序。并且連接由視圖類的構造函數完成。


建立單文檔程序ftp

在ftpview.h中加入包含#include < afxinet.h >

在ftpview.h中添加如下的成員變量
public：
CInternetSession *m_pInetsession;
CFtpConnection *m_pFtpConnection;

在ftpview.cpp中的ftpview構造函數中加入下面的代碼
CFtpView::CFtpView()
{
m_pInetSession=new CInternetsession
(AfxGetAppName(),1,
PRE_CONFIG_INTERNET_ACCESS);
try
{
m_pFtpConnection=m_pInetsession->
GetFtpConnection("FTP.MICROSOFT.COM");
}
catch(CInternetException *pEx)
{
TCHAR szError[1024];
if(pEx->GetErrorMessage(szError,1024))
AfxMessageBox(szError);
else
AfxMessageBox("There was an exception");
pEx->Delete();
m_pFtpConnection=NULL;
}
}

在ftpview.cpp中的ftpview析構函數中加入下面的代碼
CFtpView::~CFtpView()
{
if(m_pFtpConnection!=NULL)
{
m_pFtpConnection->Close();
delete m_pFtpConnection;
}
delete m_pInetsession;
}

編譯并且執行程序，如果連接出現問題，將會在一個消息框中報告出錯消息。
發送文件到FTP文件服務器

---- 創建一個發送文件到FTP文件服務器的程序

建立單文檔程序ftpfw, 在ftpfwview.h中加入包含 #include < afxinet.h >

在ftpfwview.h中添加如下的成員變量
public：
bool m_bConnectionAttempted;
int m_nFileStatus;

在ftpview.cpp中的ftpview構造函數中加入下面的代碼
CFtpfwView::CFtpfwView()
{
m_bConnectionAttempted=false;
}

使用ClassWizard加入新的類CFtpThread，該類派生于CWinThread 在ftpthread.h中加入如下變量
public:
static UINT PutFile(LPVOID Status);

添加新類成員函數代碼
UINT CFtpThread::PutFile(LPVOID Status)
{
int *pnFileStatus;
CInternetSession *pInetsession;
CFtpConnection *pFtpConnection=NULL;
pnFileStatus=(int *)Status;
*pnFileStatus=0;
pInetsession=new
CInternetsession(AfxGetAppName(),1,
PRE_CONFIG_INTERNET_ACCESS);
try
{
pFtpConnection=pInetsession->
GetFtpConnection("192.34.45.0");
}
catch(CInternetException *pEx)
{
pEx->Delete();
pFtpConnection=NULL;
*pnFileStatus=-1;
goto BallOut;
}
*pnFileStatus =1;
pFtpConnection->Remove("test.txt");
if(!pFtpConnection->PutFile
("test.txt","test.txt"))
*pnFileStatus=-2;
else
*pnFileStatus=2;
BallOut:
if(pFtpConnection!=NULL)
{
pFtpConnection->Close();
delete pFtpConnection;
}
delete pInetsession;
AfxEndThread(0);
return false;
}

編輯ftpfwview.cpp中的OnDraw()函數
void CFtpfwView::OnDraw(CDC* pDC)
{
CFtpfwDoc* pDoc = GetDocument();
ASSERT_VALID(pDoc);
if(!m_bConnectAttempted)
{
m_bConnectAttempted=TRUE;
AfxBeginThread((AFX_THREADPROC)
CFtpThread::PutFile,&m_nFileStatus);
}
}

編譯并且執行程序，在連接和傳輸的過程中，應用程序仍然可以作自己的工作，這是因為傳輸的過程發生在線程中。
總結語
---- 通過以上的程序我們可以明白FTP的工作原理，我們可以編制自己的獲得FTP服務器的文件以及獲得FTP服務器的根目錄，親自體驗一下我們的程序工作的怎末樣。