CFtpConnection::GetFile

BOOL GetFile (LPCTSTR pstrRemoteFile, LPCTSTR pstrLocalFile, BOOL bFailIfExists = TRUE, DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL, DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD dwContext = 1);

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário 0. Se a chamada falhar, a função do Win32 GetLastError pode ser chamado para determinar a causa do erro.

Parâmetros

pstrRemoteFile

Um ponteiro para uma seqüência de caracteres null-terminated que contém o nome de um arquivo para recuperar do servidor FTP.

pstrLocalFile

Um ponteiro para uma seqüência de caracteres null-terminated contendo o nome do arquivo a ser criado no sistema local.

bFailIfExists

Indica se o nome do arquivo já pode ser usado por um arquivo existente. Se o nome do arquivo local já existe, e este parâmetro é TRUE, GetFile falhará. Caso contrário, GetFile apagará a copiar existente do arquivo.

dwAttributes

Indica os atributos do arquivo. Isso pode ser qualquer combinação do seguinte sinalizadores FILE_ATTRIBUTE _ *.

dwFlags

Especifica as condições sob as quais ocorre a transferência. Este parâmetro pode ser qualquer dos valores dwFlags descritos em FtpGetFile in the Plataforma SDK.

dwContext

O identificador de contexto para a recuperação do arquivo. Consulte comentários para obter mais informações sobre como dwContext.

Observações

Chame essa função de membro para obter um arquivo de um servidor FTP e armazená-lo na máquina local.

GetFile é uma rotina de alto nível que trata de todo o overhead associado a leitura de um arquivo de um servidor FTP e armazená-los localmente. Aplicações que apenas recuperar dados de arquivos, ou que requerem Controlarar fechar sobre a transferência de arquivo, deve usar OpenFile e CInternetFile:: Read em vez disso.

Se dwFlags é FILE_TRANSFER_TYPE_ASCII, tradução de dados de arquivo também converte controle e formatação caracteres para equivalentes em Windows. A transferência de padrão é o modo binário, onde o arquivo é baixado no mesmo formato como ele é armazenado no servidor.

PstrRemoteFile e pstrLocalFile podem ser qualquer nomes de arquivo parcialmente qualificado relativo para o diretório atual ou totalmente qualificado. Uma barra invertida () ou barra (/) pode ser usada como o separador de diretório para qualquer nome. GetFile converte os separadores de nome de diretório para os caracteres apropriados antes de serem usadas.

Substituir o padrão de dwContext para definir o identificador de contexto como um valor de sua escolha. O identificador de contexto está associado esta operação específica do objeto CFtpConnection criado pelo seu objeto de CInternetSession . O valor é retornado ao CInternetSession:: OnStatusCallback para fornecer o status sobre a operação com a qual ele é identificado. Consulte o artigo Internet primeiro etapas: WinInet para obter mais informações sobre o identificador de contexto.

Visão geral de CFtpConnection |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CInternetConnection

Index