Partilhar via


CFtpConnection::OpenFile

Chame essa função de membro para em em aberto 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 seqüência de caracteres que contém o nome do arquivo a ser aberto.

  • dwAccess
    Determina como o arquivo vai ser acessado.Pode ser LEITURA_GENÉRICA ou GRAVAÇÃO_GENÉRICA, mas não ambos.

  • dwFlags
    Especifica as condições sob as quais ocorrem transferências subseqüentes.Isso pode ser qualquer uma das constantes a seguir FTP_TRANSFER_ *:

    • FTP_TRANSFER_TYPE_ASCII o arquivo transfere usando o método de transferência FTP ASCII (digite uma).Converte o controle e informações de formatação para equivalentes no locais.

    • FTP_TRANSFER_TYPE_BINARY o arquivo transfere dados usando o método de transferência de imagem FTP's (tipo I).sistema autônomo dados de transferências de arquivos exatamente sistema autônomo ela existem, sem alterações.Este é o método de transferência padrão.

  • dwContext
    O identificador de contexto para abrir o arquivo.See Comentários para obter mais informações sobre o dwContext.

Valor de retorno

Um ponteiro para um CInternetFile objeto.

Comentários

OpenFile deve ser usado nas seguintes situações:

  • Um aplicativo tem dados que precisam ser enviados e criado sistema autônomo um arquivo no servidor FTP, mas que sistema autônomo dados não estejam em um arquivo local.Uma vez OpenFile Abre um arquivo, o aplicativo usa CInternetFile::gravar para enviar os dados de arquivo do FTP no servidor.

  • Um aplicativo deve recuperar um arquivo do servidor e colocá-lo na memória controlada por aplicativo, em vez de escrevê-lo em disco.O aplicativo usa CInternetFile::Read depois de usar OpenFile Para em em aberto o arquivo.

  • Um aplicativo precisa um fino nível de controle sobre uma transferência de arquivo.Por exemplo, o aplicativo talvez queira exibir uma progresso controle indicar o andamento do status de transferência de arquivo durante o download de um arquivo.

Depois de chamar OpenFile e até a telefonar CInternetConnection::fechar, o aplicativo pode chamar apenas CInternetFile::Read, CInternetFile::gravar, CInternetConnection::fechar, or CFtpFileFind::FindFile.Chamadas para outras funções FTP para a mesma sessão FTP irão falhar e defina o código de erro para FTP_ETRANSFER_IN_PROGRESS.

The pstrFileName parâmetro pode ser um nome qualificado parcialmente 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.OpenFile Converte os separadores de nome do diretório sejam os caracteres apropriados antes de usá-lo.

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

CFtpConnection::GetFile

CGopherConnection::OpenFile

CInternetFile::gravar

CInternetFile::Read

Outros recursos

CFtpConnection membros