CFtpConnection::OpenFile

Artigo
06/10/2015

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.