CInternetSession::GetFtpConnection

Artigo
02/25/2013

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.