CFtpFileFind 類別

發行項
02/28/2013

在網際網路上的 FTP 伺服器檔案搜尋的協助。

class CFtpFileFind : public CFileFind

Members

公用建構函式

名稱	描述
CFtpFileFind::CFtpFileFind	建構 CFtpFileFind 物件。

公用方法

名稱	描述
CFtpFileFind::FindFile	尋找在 FTP 伺服器上的檔案。
CFtpFileFind::FindNextFile	繼續在前一個呼叫的檔案搜尋到 FindFile。
CFtpFileFind::GetFileURL	取得 URL，包括路徑，找到的檔案。

備註

CFtpFileFind 包括開始搜尋，尋找檔案，並傳回 URL 或其他描述性資訊有關檔案的成員函式。

用於網際網路和本機檔案設計的其他 MFC 類別中搜尋包含 CGopherFileFind 和 CFileFind。不論伺服器通訊協定或檔案類型 (本機電腦或遠端伺服器)，與 CFtpFileFind以外，這些類別為用戶端提供一種緊密的機制來尋找特定檔案。請注意不要搜尋的 MFC 類別在 HTTP 伺服器，因為不支援 HTTP 對於搜尋所需的直接檔案作業。

如需如何使用 CFtpFileFind 和其他 WinInet 類別的詳細資訊，請參閱本文 Office 方案中使用 WinInet 的網際網路。

範例

下列程式碼示範如何列舉在 FTP 伺服器上的目前目錄中的所有檔案。

// create a session object to initialize WININET library
// Default parameters mean the access method in the registry
// (that is, set by the "Internet" icon in the Control Panel)
// will be used.

CInternetSession sess(_T("My FTP Session"));

CFtpConnection* pConnect = NULL;

try
{
   // Request a connection to ftp.microsoft.com. Default
   // parameters mean that we'll try with username = ANONYMOUS
   // and password set to the machine name @ domain name
   pConnect = sess.GetFtpConnection(_T("ftp.microsoft.com"));

   // use a file find object to enumerate files
   CFtpFileFind finder(pConnect);

   // start looping
   BOOL bWorking = finder.FindFile(_T("*"));

   while (bWorking)
   {
      bWorking = finder.FindNextFile();
      _tprintf_s(_T("%s\n"), (LPCTSTR)finder.GetFileURL());
   }
}
catch (CInternetException* pEx)
{
   TCHAR sz[1024];
   pEx->GetErrorMessage(sz, 1024);
   _tprintf_s(_T("ERROR!  %s\n"), sz);
   pEx->Delete();
}

// if the connection is open, close it
if (pConnect != NULL) 
{
   pConnect->Close();
   delete pConnect;
}