CFtpConnection * GetFtpConnection (LPCTSTR pstrServer, LPCTSTR pstrUserName = NULL, LPCTSTR pstrPassword = NULL, INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, BOOL bPassive = FALSE) ;
Jeter (CInternetException);
Valeur de retour
Pointeur vers un objet CFtpConnection . Si l'appel échoue, déterminer la cause de l'échec en examinant l'objet CInternetException levée.
Paramètres
pstrServer
Un pointeur vers une chaîne contenant le nom du serveur FTP.
pstrUserName
Pointeur vers une chaîne terminée par null qui spécifie le nom de l'utilisateur pour ouvrir une session. Si la valeur NULL, la valeur par défaut est anonyme.
pstrPassword
Un pointeur vers une chaîne terminée par null qui spécifie le mot de passe à utiliser pour ouvrir une session. Si pstrPassword et pstrUserName sont NULL, le mot de passe anonyme par défaut est le nom d'utilisateur Courriel. Si pstrPassword est NULL (ou une chaîne vide), mais pstrUserName n'est pas NULL, un mot de passe vide est utilisé. Le tableau suivant décrit le comportement pour les quatre paramètres possibles de pstrUserName et de pstrPassword:
| pstrUserName | pstrPassword | Nom d'utilisateur envoyé au serveur FTP | Mot de passe envoyé à un serveur FTP |
| NULL ou "" | NULL ou "" | « anonyme » | Nom de courriel de l'utilisateur |
| Non-NULL String | NULL ou "" | pstrUserName | “ “ |
| NULL Non-NULL String | ERREUR | ERREUR | |
| Non-NULL String | Non-NULL String | pstrUserName | pstrPassword |
nPort
Un numéro qui identifie le port TCP/IP à utiliser sur le serveur.
bPassive
Spécifie le mode passive ou active pour cette session FTP. Si la valeur TRUE, il définit l' API Win32 dwFlag de INTERNET_FLAG_PASSIVE.
Remarques
Appelez cette fonction membre pour établir une connexion FTP et obtenir un pointeur vers un objet CFtpConnection.
GetFtpConnection se connecte à un serveur FTP et crée et retourne un pointeur vers un objet CFTPConnection . Il n'effectue pas une opération spécifique sur le serveur. Si vous avez l'intention de lire ou d'écrire dans des fichiers, par exemple, vous devez effectuer ces opérations en étapes distinctes. Consultez les classes CFtpConnection et CFtpFileFind pour plus d'informations la recherche de fichiers, ouverture de fichiers et de lire ou d'écrire dans les fichiers. Consultez l'article Internet programmation avec WinInet dans le Guide du programmeur Visual C++ pour les étapes d'exécution de tâches courantes de connexion FTP.
CInternetSession aperçu |nbsp ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;CFtpConnection CInternetSession::GetGopherConnection, CInternetSession::GetHttpConnection, CInternetSession::OpenURL