CFtpConnection * GetFtpConnection (LPCTSTR pstrServer, LPCTSTR pstrUserName = NULL, LPCTSTR pstrPassword = NULL, INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, BOOL bPassive = FALSE);
Lançar (CInternetException);
Valor de retorno
Um ponteiro para um objeto de CFtpConnection . Se a chamada falhar, determinar a causa da falha, examinando o objeto de CInternetException gerado.
Parâmetros
pstrServer
Um ponteiro para uma Cadeia de caracteres contendo o nome do servidor FTP.
pstrUserName
Ponteiro para uma seqüência de caracteres null-terminated que especifica o nome do usuário para efetuar login. Se NULL, o padrão é anônimo.
pstrPassword
Um ponteiro para uma seqüência de caracteres null-terminated que especifica a senha a usar para fazer logon. Se ambos pstrPassword e pstrUserName são NULL, a senha de usuário anônimo padrão é nome de email do usuário. Se pstrPassword é NULL (ou uma cadeia vazia) mas pstrUserName não é NULL, é usada uma senha em branco. A tabela a seguir descreve o comportamento para as configurações possíveis quatro pstrUserName e pstrPassword:
| pstrUserName | pstrPassword | Nome de usuário enviada ao servidor FTP | Senha enviada ao servidor FTP |
| NULL ou "" | NULL ou "" | "anônimo" | Nome de email do usuário |
| Não-NULL seqüência de caracteres | NULL ou "" | pstrUserName | “ “ |
| Nulo Não-NULL seqüência de caracteres | ERRO | ERRO | |
| Não-NULL seqüência de caracteres | Não-NULL seqüência de caracteres | pstrUserName | pstrPassword |
nPort
Um número que identifica a porta de TCP/IP para usar no servidor.
bPassive
Especifica o modo passivo ou ativo para esta sessão FTP. Se definido como TRUE, ele define a API do Win32 dwFlag a INTERNET_FLAG_PASSIVE.
Observações
Chame essa função de membro para estabelecer uma conexão FTP e get um ponteiro para um objeto de CFtpConnection.
GetFtpConnection se conecta a um servidor FTP e cria e retorna um ponteiro para um objeto de CFTPConnection . Ele não executa qualquer operação específica no servidor. Se você pretende ler ou gravar em arquivos, por exemplo, você deve executar essas operações como etapas separadas. Consulte os classes CFtpConnection e CFtpFileFind para obter informações pesquisa de arquivos, abrir arquivos e ler ou gravar arquivos. Consulte o artigo Internet programação com WinInet no Guia do programador do Visual C++ para etapas executar tarefas ComComumComum de conexão FTP.
Visão geral de CInternetSession |nbsp; Membros de classe | Gráfico de hierarquia
Co&nsulte tambémnbsp;CFtpConnection CInternetSession:: GetGopherConnection, CInternetSession:: GetHttpConnection, CInternetSession:: OpenURL