CInternetSession:: GetFtpConnection

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

Index