CInternetSession::GetFtpConnection

Artigo
06/10/2015

Chamar essa função de membro para estabelecer uma conexão FTP e para obter um ponteiro para um objeto de CFtpConnection .

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 cadeia de caracteres que contém o nome do servidor FTP.
pstrUserName
Ponteiro para uma cadeia de caracteres NULL- finalizada que especifica o nome do usuário entre. Se NULO, o padrão é anônimo.

pstrPassword
Um ponteiro para uma cadeia de caracteres NULL- finalizada que especifica a senha para se usar para fazer logon. Se pstrPassword e pstrUserName são NULO, a senha anônima padrão é o nome de email do usuário. Se pstrPassword é NULO (ou uma cadeia de caracteres vazia) pstrUserName mas não é NULO, uma senha em branco é usada. A tabela a seguir descreve o comportamento para as quatro possíveis configurações de pstrUserName e de pstrPassword:

pstrUserName	pstrPassword	Nome de usuário enviado ao servidor FTP	Senha enviada para o servidor FTP
NULO “ou “	NULO “ou “	“anônimo”	Nome de email do usuário
Cadeia de caracteres não deNULO	NULO “ou “	pstrUserName	““
Cadeia de caracteres nãoNULO deNULO	ERRO	ERRO
Cadeia de caracteres não deNULO	Cadeia de caracteres não deNULO	pstrUserName	pstrPassword

nPort
Um número que indica a porta tcp/para usar no servidor.
bPassive
Especifica o modo passivo ou ativo para a sessão FTP. Se definida como Verdadeiro, ele define a API do Win32 dwFlag a INTERNET_FLAG_PASSIVE.

Valor de retorno

Um ponteiro para um objeto de CFtpConnection . Se a chamada falha, determinar a causa de falha examinando o objeto de CInternetException lançada.

Comentários

GetFtpConnection se conectar a um servidor FTP, e cria e retorna um ponteiro para um objeto de CFTPConnection . Não realiza nenhuma operação específica no servidor. Se você pretende ler ou gravar arquivos, por exemplo, você deve executar essas operações como etapas separadas. Consulte para classes CFtpConnection e CFtpFileFind para obter informações sobre pesquisa por arquivos, para abrir arquivos, e ler ou escrevê-los de arquivos. Consulte o artigo Internet que programa com WinInet para as etapas para executar tarefas comuns de conexão FTP.