CFtpConnection::GetFile
Chame essa função de membro para obter um arquivo de um servidor FTP e armazená-lo na computador local.
BOOL GetFile(
LPCTSTR pstrRemoteFile,
LPCTSTR pstrLocalFile,
BOOL bFailIfExists = TRUE,
DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1
);
pstrRemoteFile
Um ponteiro para uma cadeia terminada com nulo que contém o nome de arquivo para recuperar do servidor FTP.pstrLocalFile
Um ponteiro para uma cadeia terminada com nulo que contém o nome do arquivo a ser criado no sistema local.bFailIfExists
Indica se nome de arquivo já pode ser usado por um arquivo existente.Se nome de arquivo local já existe e este parâmetro for TRUE, GetFile Falha. Caso contrário, GetFile apagará a cópia do arquivo existente.dwAttributes
Indica os atributos do arquivo.Isso pode ser qualquer combinação dos sinalizadores a seguir FILE_ATTRIBUTE_ *.FILE_ATTRIBUTE_ARCHIVE o arquivar está um arquivar.Aplicativos usam esse atributo para marcar os arquivos de backup ou de remoção.
FILE_ATTRIBUTE_COMPRESSED o arquivo ou diretório está compactado.Para um arquivo, compactação significa que todos os dados no arquivo é compactado.Para uma pasta, compactação é o padrão para novos arquivos e subdiretórios.
FILE_ATTRIBUTE_DIRECTORY o arquivo é um diretório.
FILE_ATTRIBUTE_NORMAL o arquivo não tiver outros atributos conjunto.Esse atributo é válido somente se usado sozinho.Todos os outros atributos de arquivo substituem FILE_ATTRIBUTE_NORMAL:
FILE_ATTRIBUTE_HIDDEN o arquivo está oculto.Ele não é ser incluídos em uma listagem de diretório comum.
FILE_ATTRIBUTE_READONLY o arquivo é somente leitura.Aplicativos podem ler o arquivo mas não é possível gravar nele ou excluí-lo.
FILE_ATTRIBUTE_SYSTEM o arquivo é parte de ou é usado exclusivamente pelo sistema operacional.
FILE_ATTRIBUTE_TEMPORARY o arquivo está sendo usado para armazenamento temporário.Aplicativos devem gravar o arquivo apenas se absolutamente necessário.A maioria dos dados do arquivo permanece na memória sem sendo liberadas para a mídia como o arquivo de logo será ser excluído.
dwFlags
Especifica as condições sob as quais a transferência ocorre.Este parâmetro pode ser qualquer um do dwFlags valores descritos na FtpGetFile in the Windows SDK.dwContext
O identificador de contexto para a recuperação de arquivo.See Comentários para obter mais informações sobre o dwContext.
Diferente de zero se bem-sucedida; caso contrário, 0.Se a telefonar falhar, o Win32 funcionar GetLastError pode ser chamado para determinar a causa do erro.
GetFile é uma rotina de alto nível que trata toda a sobrecarga associada à leitura de um arquivo de um servidor FTP e armazená-la localmente. Aplicativos que só recuperar dados de arquivo ou que exigem o próximo controle sobre a transferência de arquivo, devem usar OpenFile e CInternetFile::Read em vez disso.
If dwFlags FILE_TRANSFER_TYPE_ASCII, conversão de arquivo de dados também é controle converte e formatação de caracteres para os equivalentes do Windows. A transferência de padrão é o modo binário, onde o arquivo é baixado no mesmo formato, conforme armazenado no servidor.
Ambos os pstrRemoteFile e pstrLocalFile pode ser qualquer um dos nomes de arquivo parcialmente qualificado relativo ao diretório corrente ou totalmente qualificado. Uma barra / / invertida (\\\) ou uma barra / / (/) pode ser usada sistema autônomo o separador de diretório para qualquer nome.GetFile Converte os separadores de nome do diretório sejam os caracteres apropriados antes de serem usadas.
Substituir o dwContext padrão para conjunto o identificador de contexto com um valor de sua escolha. O identificador de contexto está associado a esta operação específica do CFtpConnection objeto criado pelo seu CInternetSession objeto.O valor será retornado para CInternetSession::OnStatusCallback para fornecer status sobre a operação com o qual ela é identificada.Consulte o artigo Internet etapas primeira: WinInet para obter mais informações sobre o identificador de contexto.
Cabeçalho: afxinet.h