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 
);

Parâmetros

  • 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.

Valor de retorno

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.

Comentários

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.

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

Classe CFtpConnection

Gráfico de hierarquia

Classe CInternetConnection

Outros recursos

CFtpConnection membros