GetFtpConnection

CInternetSession::GetFtpConnection

CFtpConnection* GetFtpConnection(LPCTSTR pstrServer,

LPCTSTR pstrUserName = NULL,

LPCTSTR pstrPassword = NULL,

INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,

BOOL bPassive = FALSE

);

throw(CInternetException);

返回值：

指向CFtpConnection对象的指针。如果调用失败，可通过检查产生的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