CInternetSession::GetFtpConnection

Artigo
08/25/2010

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.