CInternetSession::GetFtpConnection

發行項
02/28/2013

呼叫此成員函式建立 FTP 連接和取得指標與 CFtpConnection 物件。

CFtpConnection* GetFtpConnection(
   LPCTSTR pstrServer,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   BOOL bPassive = FALSE 
);

參數

pstrServer
out 包含 FTP 伺服器名稱之字串的指標。
pstrUserName
為指定的使用者名稱登入的 NULL 結尾字串的指標。如果 NULL，預設值為匿名的。

pstrPassword
會指定要使用的密碼登入的 NULL 結尾字串的指標。如果 pstrPassword 和 pstrUserName 是 NULL，預設密碼為匿名使用者的電子郵件名稱。如果 pstrPassword 是 NULL (或空字串)，但 pstrUserName 不是 NULL，使用空白密碼。下表說明 pstrUserName 和 pstrPassword四種可能的設定的行為:

pstrUserName	pstrPassword	使用者名稱傳送至 FTP 伺服器。	密碼會傳送至 FTP 伺服器。
NULL 「或「	NULL 「或「	「匿名」	使用者的電子郵件名稱
非NULL 字串	NULL 「或「	pstrUserName	" "
NULL 非NULL 字串	錯誤	錯誤
非NULL 字串	非NULL 字串	pstrUserName	pstrPassword

nPort
在伺服器識別 TCP/IP 通訊埠使用的數字。
bPassive
對於這個 FTP 指定被動或作用中模式。如果為是的集合中，則設定 Win32 API dwFlag 至 INTERNET_FLAG_PASSIVE。

傳回值

為 CFtpConnection 物件的指標。如果呼叫失敗，請先檢查時所擲回的 CInternetException 物件判斷失敗的原因。

備註

GetFtpConnection 連接到 FTP 伺服器，以及建立和傳回指向 CFTPConnection 物件。它不在伺服器上執行任何特殊作業。如果您想要，例如，讀取或寫入檔案必須執行這些作業為個別的步驟。如需搜尋檔案，開啟檔案和讀取或寫入檔案的詳細資訊，請參閱類別 CFtpConnection 和 CFtpFileFind 。針對執行共同 FTP 連接工作的步驟參閱本文 Office 方案中使用 WinInet 的網際網路。