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字符串
ERROR
ERROR
非NULL字符串非NULL字符串
pstrUserName
pstrPassword

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