CFtpConnection::OpenFile

Artigo
02/25/2013

Chamar essa função de membro para abrir um arquivo localizado em um servidor FTP para leitura ou gravação.

CInternetFile* OpenFile(
   LPCTSTR pstrFileName,
   DWORD dwAccess = GENERIC_READ,
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
   DWORD_PTR dwContext = 1 
);

Parâmetros

pstrFileName
Um ponteiro para uma cadeia de caracteres que contém o nome do arquivo a ser aberto.
dwAccess
Determina como o arquivo será acessado.Podem ser GENERIC_READ ou GENERIC_WRITE, mas não ambos.
dwFlags
Especifica as condições em que transfere subseqüentes ocorrem.Isso pode ser qualquer uma das seguintes constantes de FTP_TRANSFER_*:
- FTP_TRANSFER_TYPE_ASCII as transferências de arquivos usando FTP (ASCII método de transferência de tipo Para).Converte controle e informações de formatação para equivalentes locais.
- FTP_TRANSFER_TYPE_BINARY os dados da transferências de arquivos usando a imagem FTP (método de transferência de tipo I).Os dados da transferências de arquivos exatamente como existir, sem alterações.Este é o método padrão de transferência.
dwContext
O identificador de contexto para abrir o arquivo.Consulte Comentários para obter mais informações sobre dwContext.

Valor de retorno

Um ponteiro para um objeto de CInternetFile .

Comentários

OpenFile deve ser usado nas seguintes situações:

Um aplicativo possui os dados que precisam ser enviados e criado como um arquivo no servidor FTP, mas os dados que não estão em um arquivo local.Uma vez que OpenFile abrir um arquivo, o aplicativo usa CInternetFile::Write para enviar os dados do arquivo ftp para o servidor.
Um aplicativo deve recuperar um arquivo de servidor e coloque-o na memória o controle, em vez de escrevê-la no disco.O aplicativo usa CInternetFile::Read após OpenFile usado para abrir o arquivo.
Um aplicativo precisa um nível de controle fino sobre uma transferência de arquivo.Por exemplo, o aplicativo pode exibir um controle de andamento indica o andamento de status de transferência de arquivo para baixar um arquivo.

Após chamar OpenFile e até chamar CInternetConnection::Close, o aplicativo pode chamar somente CInternetFile::Read, CInternetFile::Write, CInternetConnection::Close, ou CFtpFileFind::FindFile.Chamadas a outras funções de FTP para a mesma sessão FTP irão falhar e definirá o código de erro a FTP_ETRANSFER_IN_PROGRESS.

o parâmetro de pstrFileName pode ser um nome de arquivo parcialmente qualificado relativo ao diretório atual ou totalmente qualificado.Uma barra invertida (\) ou a barra (/) podem ser usadas como o separador de diretório para qualquer nome.OpenFile converte os separadores do nome de diretório para caracteres apropriadas antes de usá-lo.

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.