Partilhar via


CInternetSession::GetFtpConnection

telefonar Essa função de membro para estabelecer uma conexão FTP e obter um apontador para um CFtpConnection objeto.

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

Parâmetros

  • pstrServer
    Um ponteiro para uma seqüência de caracteres que contém o nome do servidor FTP.

  • pstrUserName
    Ponteiro para uma seqüência de caracteres terminada com nulo que especifica o nome do usuário para log no.If NULO, o padrão é anônimo.

  • pstrPassword
    Um ponteiro para uma seqüência de caracteres terminada com nulo que especifica a senha a ser usada para efetuar login.Se ambos os pstrPassword e pstrUserName são NULO, a senha anônima padrão é o nome do email.If pstrPassword é NULO (ou uma seqüência vazia), mas pstrUserName não é NULO, uma senha em branco é usado.A tabela a seguir descreve o comportamento para as quatro configurações possíveis pstrUserName e pstrPassword:

    pstrUserName

    pstrPassword

    Nome de usuário enviado ao servidor FTP

    Senha enviada ao servidor FTP

    NULOor " "

    NULOor " "

    "anônimo"

    Nome de email do usuário

    Non-NULO Seqüência de caracteres

    NULOor " "

    pstrUserName

    " "

    NULO Non-NULO Seqüência de caracteres

    ERRO

    ERRO

     

    Non-NULO Seqüência de caracteres

    Non-NULO Seqüência de caracteres

    pstrUserName

    pstrPassword

  • nPort
    Um número que identifica a porta TCP/IP para usar no servidor.

  • bPassive
    Especifica o modo passivo ou ativo para esta sessão FTP.If conjunto to TRUE,-s conjunto a Win32 API dwFlag para INTERNET_FLAG_PASSIVE.

Valor de retorno

Um ponteiro para um CFtpConnection objeto.Se a telefonar falhar, determinar a causa da falha, examinando o geradas CInternetException objeto.

Comentários

GetFtpConnection se conecta a um servidor FTP e cria e retorna um ponteiro para um CFTPConnection objeto.Ele não executa qualquer operação específica no servidor.Por exemplo, se você pretende ler ou gravar em arquivos, você deve executar essas operações sistema autônomo etapas separadas.Consulte as classes CFtpConnection and CFtpFileFind para obter informações sobre como procurando arquivos, abrir arquivos e ler ou gravar em arquivos.Consulte o artigo Programação de Internet com WinInet para o procedimento de executar tarefas comuns de conexão FTP.

Exceções

Esse método pode lançar exceções do tipo CInternetException*.

Exemplo

Consulte o exemplo para CFtpFileFind.

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

Classe CInternetSession

Gráfico de hierarquia

Classe CFtpConnection

CInternetSession::GetGopherConnection

CInternetSession::GetHttpConnection

CInternetSession::OpenURL

Outros recursos

CInternetSession membros