CFtpConnection::CFtpConnection

Artículo
06/10/2015

Esta función miembro se denomina para construir un objeto de CFtpConnection .

CFtpConnection( 
   CInternetSession* pSession, 
   HINTERNET hConnected, 
   LPCTSTR pstrServer, 
   DWORD_PTR dwContext 
); 
CFtpConnection( 
   CInternetSession* pSession, 
   LPCTSTR pstrServer, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL, 
   DWORD_PTR dwContext = 0, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   BOOL bPassive = FALSE 
);

Parámetros

pSession
Un puntero al objeto relacionado de CInternetSession .
hConnected
El identificador de Windows de la sesión actual de internet.
pstrServer
Un puntero a una cadena que contiene el nombre del servidor FTP.
dwContext
El identificador del contexto de la operación. dwContext identifica la información de estado de la operación devuelta por CInternetSession:: OnStatusCallback. El valor predeterminado se establece en 1; sin embargo, puede asignar explícitamente un Id. de contexto específico para la operación. El objeto y cualquier trabajo que lo haga se asociado con ese identificador de contexto
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.

Comentarios

Nunca se crea un objeto de CFtpConnection directamente. En su lugar, llamada CInternetSession:: GetFtpConnection, que crea el objeto de CFptConnection .