CInternetSession::GetFtpConnection

项目
03/01/2013

调用该成员函数为FTP连接和具有指针 CFtpConnection 对象。

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

参数

pstrServer
对包含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会话指定被动或活动模式。如果设置为 TRUE，它将Win32 API dwFlag 到 INTERNET_FLAG_PASSIVE。

返回值

为 CFtpConnection 对象的指针。如果调用失败，请通过检查时引发的 CInternetException 对象以确定失败的原因。

备注

GetFtpConnection 连接到FTP服务器，并创建并返回指向 CFTPConnection 对象。它不对服务器的任何特定操作。如果要读取或写入文件，例如，必须执行这些操作作为单独的步骤。请参见选件类 CFtpConnection 和 CFtpFileFind 有关搜索文件，打开文件并读取或写入的信息保存到文件。为执行常规FTP连接的任务的步骤参见中的文章编程时WinInet的Internet。