CInternetSession::GetFtpConnection

Article
03/04/2013

Appelez la fonction membre pour établir une connexion FTP et pour obtenir un pointeur vers un objet d' CFtpConnection .

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

Paramètres

pstrServer
Un pointeur vers une chaîne contenant le nom du serveur FTP.
pstrUserName
Pointeur vers une chaîne terminée par le caractère NULL qui spécifie le nom d'utilisateur pour ouvrir une session.Si NULL, la valeur par défaut est anonyme.

pstrPassword
Un pointeur vers une chaîne terminée par le caractère NULL qui spécifie le mot de passe à utiliser pour vous connecter.Si pstrPassword et pstrUserName sont NULL, le mot de passe anonyme par défaut est le nom de la messagerie électronique de l'utilisateur.Si pstrPassword est NULL (ou une chaîne vide) mais pstrUserName n'est pas NULL, les mots de passe vide sont utilisés.Le tableau suivant décrit le comportement des quatre paramètres possibles d' pstrUserName et d' pstrPassword:

pstrUserName	pstrPassword	Nom d'utilisateur envoyé au serveur FTP	Mot de passe envoyée au serveur FTP
NULL ou « «	NULL ou « «	« anonyme »	Nom de la messagerie électronique de l'utilisateur
Chaîne non deNULL	NULL ou « «	pstrUserName	" "
Chaîne non deNULLNULL	ERREUR	ERREUR
Chaîne non deNULL	Chaîne non deNULL	pstrUserName	pstrPassword

nPort
Un nombre qui identifie le port de TCP/IP pour l'utiliser sur le serveur.
bPassive
Spécifie le mode passif ou actif de cette session FTP.Si la valeur TRUE, il définit l'API Win32 dwFlag à INTERNET_FLAG_PASSIVE.

Valeur de retour

Un pointeur vers un objet de CFtpConnection .Si l'appel échoue, déterminez la cause de l'échec en examinant l'objet levé de CInternetException .

Notes

GetFtpConnection se connecte à un serveur FTP, et crée et retourne un pointeur vers un objet de CFTPConnection .Il n'effectue aucune opération spécifique sur le serveur.Si vous avez l'intention de lire ou écrire dans les fichiers, par exemple, vous devez effectuer ces opérations comme étapes distinctes.Consultez les classes CFtpConnection et le CFtpFileFind pour plus d'informations sur la recherche de fichiers, ouvrir des fichiers, et lire ou d'écrire dans les fichiers.Consultez l'article Programmation avec Internet WinInet pour les étapes en effectuant les tâches courantes de connexion FTP.