指向CFtpConnection對象的指針。如果調用失敗,可通過檢查產生的CInternetException對象來確定出錯類型。
基本介紹
- 外文名:GetFtpConnection
- pstrServer:指向包含FTP伺服器字元串的指針
- nPort:表示伺服器上使用TCP/IP連線埠數字
- 作用:建立一個FTP連線
CInternetSession::GetFtpConnection
CFtpConnection* GetFtpConnection(LPCTSTR pstrServer,
LPCTSTR pstrUserName = NULL,
LPCTSTR pstrPassword = NULL,
INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
BOOL bPassive = FALSE
);
throw(CInternetException);
返回值:
參數:
pstrServer | 指向包含FTP伺服器的字元串的指針。 |
pstrUserName | 指向確定記入日誌的用戶名的空終止字元串的指針。如果為NULL,預設為匿名。 |
pstrPassword | 指向確定用於登錄的口令的空終止字元串的指針。如果pstrPassword和pstrUserName都為NULL,預設匿名口令為用戶email名字。如果pstrPassword為NULL(或空字元串)而pstrUserName不為NULL,可用空白口令。下列表格描述pstrUserName和pstrPassword四個可能設定的行為: pstrUserNamepstrPassword傳送到FTP伺服器的用戶名傳送到FTP伺服器的口令 NULL或" "NULL或" ""anonymous"用戶的e-mail名字 非NULL字元串NULL或" "pstrUserName"" NULL非NULL字元串ERRORERROR 非NULL字元串非NULL字元串pstrUserNamepstrPassword |
nPort | 一個表示伺服器上使用的TCP/IP連線埠的數字。 |
bPassive | 指定此FTP會話的被動或主動模式。如果設定為TRUE,它將Win32API dwFlag設定為INTERNET_FLAG_PASSIVE。 |
說明:
調用此成員函式來建立一個FTP連線並獲取指向CFtpConnection對象的指針。
GetFtpConnection連線到一個FTP伺服器,創建並返回指向CFTPConnection對象的指針。它不執行伺服器的指定操作。例如,如果要讀取或寫入檔案,必須分步執行那些操作。請參閱類CFtpConnection和CFtpFileFind以了解查找檔案、打開檔案和讀取或寫入檔案的信息。
請參閱在線上文檔“Visual C++程式設計師指南”中的“使用WinInet編寫Internet程式”,以了解執行一般FTP連線任務的步驟。
請參閱:
CFtpConnection, CInternetSession::GetGopherConnection, CInternetSession::GetHttpConnection, CInternetSession::OpenURL