CFtpConnection::CFtpConnection

Article
06/10/2015

Cette fonction membre est appelée pour construire un objet d' 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 
);

Paramètres

pSession
Pointeur vers l'objet relatif de CInternetSession .
hConnected
Le handle de fenêtre de la session Internet.
pstrServer
Un pointeur vers une chaîne contenant le nom du serveur FTP.
dwContext
l'identificateur de contexte pour l'exécution. dwContext identifie les informations d'état de l'opération retournées par CInternetSession::OnStatusCallback. La valeur par défaut est 1 ; toutefois, vous pouvez explicitement assigner un ID de contexte spécifique de l'exécution. L'objet et tout travail qu'il exécute sont associés à cet ID. de contexte
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.

Notes

Vous ne créez jamais directement un objet d' CFtpConnection . À la place, appelez CInternetSession::GetFtpConnection, qui crée l'objet de CFptConnection .