CInternetSession::GetFtpConnection

Artículo
06/10/2015

Llame a esta función miembro para establecer una conexión FTP y obtener un puntero a un objeto de CFtpConnection .

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

Parámetros

pstrServer
Un puntero a una cadena que contiene el nombre del servidor FTP.
pstrUserName
Puntero a una cadena terminada en null que especifica el nombre de usuario de inicio de sesión. Si NULL, el valor predeterminado es anónimo.

pstrPassword
Un puntero a una cadena terminada en null que especifica la contraseña para iniciar sesión. Si pstrPassword y pstrUserName son NULL, la contraseña anónima predeterminada es el nombre de correo electrónico del usuario. si pstrPassword es NULL (o una cadena vacía) pero pstrUserName no es NULL, se utiliza una contraseña en blanco. la tabla siguiente describe el comportamiento por los cuatro valores posibles de pstrUserName y de pstrPassword:

pstrUserName	pstrPassword	Nombre de usuario enviado al servidor FTP	Contraseña envíe al servidor FTP
NULL o ““	NULL o ““	“anónimo”	El nombre de correo electrónico del usuario
Cadena que no sea NULL	NULL o ““	pstrUserName	" "
Cadena no NULL deNULL	ERROR	ERROR
Cadena que no sea NULL	Cadena que no sea NULL	pstrUserName	pstrPassword

nPort
Un número que identifica el puerto TCP/IP para usar en el servidor.
bPassive
Especifica el modo pasivo o activo para esta sesión FTP. Si se establece en TRUE, establece que la API Win32 dwFlag a INTERNET_FLAG_PASSIVE.

Valor devuelto

Un puntero a un objeto de CFtpConnection . Si se produce un error en la llamada, determine la causa del error examinando el objeto iniciado de CInternetException .

Comentarios

GetFtpConnection se conecta a un servidor FTP, y crea y devuelve un puntero a un objeto de CFTPConnection . No realiza ninguna operación concreta del servidor. Si desea leer o escribir en archivos, por ejemplo, debe realizar estas operaciones en pasos independientes. Vea las clases CFtpConnection y CFtpFileFind para obtener información sobre cómo buscar archivos, abrir archivos, y leer o escribir en archivos. Vea el artículo Internet que programa con WinInet para los pasos de realizar tareas comunes de la conexión FTP.