CFtpConnection::GetFile
Chamar essa função de membro para obter um arquivo de um servidor FTP e armazená-lo no 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
);
Parâmetros
pstrRemoteFile
Um ponteiro para uma cadeia de caracteres NULL- finalizada que contém o nome de um arquivo para recuperar o servidor FTP.pstrLocalFile
Um ponteiro para uma cadeia de caracteres NULL- finalizada que contém o nome do arquivo para criar no sistema local.bFailIfExists
Indica se o nome de arquivo pode mais ser usado por um arquivo existente.Se o nome do arquivo local já existir, este parâmetro é Verdadeiro, GetFile falhar.Caso contrário, GetFile apagará a impressão existente do arquivo.dwAttributes
Indica os atributos de arquivo.Isso pode ser qualquer combinação dos sinalizadores de FILE_ATTRIBUTE_*.FILE_ATTRIBUTE_ARCHIVE o arquivo é um arquivo neutro.Aplicativos usam esse atributo para marcar os arquivos de backup ou de remoção.
FILE_ATTRIBUTE_COMPRESSED o arquivo ou diretório for compactado.Para um arquivo, a compactação significa que todos os dados no arquivo são compactados.Para um diretório, a compactação é o padrão para arquivos e subpastas recém-criado.
FILE_ATTRIBUTE_DIRECTORY o arquivo é um diretório.
FILE_ATTRIBUTE_NORMAL o arquivo não tem outros atributos definidos.Esse atributo é válido somente se usado sozinho.Todos outros atributos de arquivo substituem FILE_ATTRIBUTE_NORMAL:
FILE_ATTRIBUTE_HIDDEN o arquivo está oculto.Não deve ser incluído em uma listagem de diretório.
FILE_ATTRIBUTE_READONLY o arquivo é somente leitura.Os aplicativos podem ler o arquivo mas não podem gravar ou excluí-lo.
FILE_ATTRIBUTE_SYSTEM o arquivo é parte ou é usado exclusivamente pelo sistema operacional.
FILE_ATTRIBUTE_TEMPORARY o arquivo está sendo usado para armazenamento temporário.Os aplicativos devem gravar o arquivo somente se absolutamente necessário.A maioria dos dados do arquivo permanece na memória sem ser liberado mídia porque o arquivo será excluído brevemente.
dwFlags
Especifica as condições em que ocorre a transferência.Este parâmetro pode ser qualquer um dos valores de dwFlags descritos em FtpGetFile em Windows SDK.dwContext
O identificador de contexto para a recuperação de arquivo.Consulte Comentários para obter mais informações sobre dwContext.
Valor de retorno
Diferente de zero se com êxito; se não 0.Se a chamada falha, a função GetLastError Win32 pode ser chamado para determinar a causa do erro.
Comentários
GetFile é uma rotina de alto nível que trata toda a sobrecarga associada ao ler um arquivo de um servidor FTP e o armazenar localmente.Os aplicativos que recuperam dados somente de arquivo, ou que exigem o próximo controle sobre a transferência de arquivo, devem usar OpenFile e CInternetFile::Read em vez de isso.
Se dwFlags é FILE_TRANSFER_TYPE_ASCII, conversão de converte controle de dados do arquivo e também caracteres de formatação para equivalentes do windows.A transferência padrão é o modo binário, onde o arquivo é baixado no mesmo formato que é armazenado no servidor.
pstrRemoteFile e pstrLocalFile podem ser nomes de arquivo relativo ao diretório atual ou totalmente qualificados parcialmente qualificado.Uma barra invertida (\) ou a barra (/) podem ser usadas como o separador de diretório para qualquer nome.GetFile converte os separadores do nome de diretório para caracteres apropriadas antes que eles sejam usados.
Substitua a opção de dwContext para definir o identificador de contexto a um valor de sua escolha.O identificador de contexto é associado com esta operação específica do objeto de CFtpConnection criado pelo seu objeto de CInternetSession .O valor é retornado para CInternetSession::OnStatusCallback para fornecer o status da operação com que é identificado.Consulte o artigo Primeiras etapas da Internet: WinInet para obter mais informações sobre o identificador de contexto.
Requisitos
Cabeçalho: afxinet.h