CInternetSession::GetFtpConnection

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

Valor devuelto

Un puntero a un objeto CFtpConnection . Si la llamada falla, determinar la causa del fracaso examinando el objeto echado de CInternetException.

Parámetros

pstrServer

Un puntero a una cadena que contiene el nombre del servidor FTP.

pstrUserName

Puntero a una cadena terminada en nulo que especifica el nombre del usuario para iniciar sesión. Si es NULL, el valor por defecto anónimo.

pstrPassword

Un puntero a una cadena terminada en nulo que especifica la contraseña que utilice 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 de los cuatro posibles configuraciones de pstrUserName y pstrPassword:

pstrUserName pstrPassword Nombre de usuario envía al servidor de FTP Contraseña enviada al servidor FTP
Nulo o "" Nulo o "" "anónimo" Nombre de correo electrónico del usuario
No-cadenanula Nulo o "" pstrUserName “ “
Nulo No-cadenanula ERROR ERROR
No-cadenanula No-cadenanula pstrUserName pstrPassword

nPort

Un número que identifica el puerto TCP/IP para utilizar en el servidor.

bPassive

Especifica el modo pasivo o activo para esta sesión FTP. Si se establece en TRUE, establece la API Win32 dwFlag a INTERNET_FLAG_PASSIVE.

Observaciones

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

GetFtpConnection se conecta a un servidor FTP y crea y devuelve un puntero a un objeto CFTPConnection . No realiza ninguna operación específica en el servidor. Si desea leer o escribir en archivos, por ejemplo, debe realizar estas operaciones como pasos independientes. Vea las clases CFtpConnection y CFtpFileFind para obtener información acerca de buscar archivos, abrir archivos y leer o escribir en archivos. Consulte el artículo Internet programación con WinInet en la Guía del programador de Visual C++ para pasos en la realización de tareas comunes de conexión FTP.

Introducción a CInternetSession |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CFtpConnection CInternetSession::GetGopherConnection, CInternetSession::GetHttpConnection, CInternetSession:: OpenURL

Index