CInternetSession::GetFtpConnection

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.

Eccezioni

Questo metodo può generare eccezioni di tipo CInternetException*.

Esempio

Vedere l'esempio relativo CFtpFileFind.

Requisiti

Header: afxinet.h

Vedere anche

Riferimenti

Classe di CInternetSession

Grafico della gerarchia

Classe di CFtpConnection

CInternetSession::GetGopherConnection

CInternetSession::GetHttpConnection

CInternetSession::OpenURL