CInternetSession::GetFtpConnection

Articolo
03/05/2013

Chiamare la funzione membro per stabilire una connessione FTP e ottenere un puntatore a un oggetto CFtpConnection.

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

Parametri

pstrServer
Un puntatore a una stringa contenente il nome del server FTP.
pstrUserName
Puntatore a una stringa con terminazione null che specifica il nome dell'utente.Se NULL, l'impostazione predefinita è anonimo.

pstrPassword
Un puntatore a una stringa con terminazione null che specifica la password da utilizzare per accedere.Se è pstrPassword che pstrUserName sono NULL, la password utente anonimo predefinito è il nome della posta elettronica dell'utente.Se pstrPassword è NULL o una stringa vuota pstrUserName ma non è NULL, una password vuota viene utilizzato.Nella tabella seguente viene descritto il comportamento per le quattro impostazioni possibili pstrUserName e pstrPassword:

pstrUserName	pstrPassword	Nome utente inviata al server FTP	Password inviato al server FTP
NULL o "	NULL o "	"anonimo"	Nome della posta elettronica dell'utente
Stringa null non	NULL o "	pstrUserName	" "
Stringa null non diNULL	ERRORE	ERRORE
Stringa null non	Stringa null non	pstrUserName	pstrPassword

nPort
Un numero che identifica la porta TCP/IP per utilizzare il server.
bPassive
Specifica la modalità passiva o attivo per questa sessione FTP.Se impostato su TRUE, impostare l'api Win32 dwFlag a INTERNET_FLAG_PASSIVE.

Valore restituito

Un puntatore a un oggetto CFtpConnection.Se la chiamata ha esito negativo, determinare la causa dell'errore dall'analisi dell'oggetto generato CInternetException.

Note

GetFtpConnection si connette a un server FTP e crea e restituisce un puntatore a un oggetto CFTPConnection.Non esegue alcuna operazione specifica del server.Se si desidera leggere o scrivere nei file, ad esempio, è necessario eseguire le operazioni come singoli passaggi.Vedere le classi CFtpConnection e CFtpFileFind per informazioni sulla ricerca dei file, aprire i file e la lettura o la scrittura nei file.Vedere l'articolo Programmazione per Internet con ATL per i passaggi nell'eseguire attività comuni di connessione FTP.