Função FtpPutFileA (wininet.h)

  • Artigo

Armazena um arquivo no servidor FTP.

Sintaxe

BOOL FtpPutFileA(
  [in] HINTERNET hConnect,
  [in] LPCSTR    lpszLocalFile,
  [in] LPCSTR    lpszNewRemoteFile,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Parâmetros

[in] hConnect

Manipule para uma sessão FTP.

[in] lpszLocalFile

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo a ser enviado do sistema local.

[in] lpszNewRemoteFile

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do arquivo a ser criado no sistema remoto.

[in] dwFlags

Condições sob as quais as transferências ocorrem. O aplicativo deve selecionar um tipo de transferência e qualquer um dos sinalizadores que controlam como o cache do arquivo será controlado.

O tipo de transferência pode ser qualquer um dos valores a seguir.

Valor Significado
FTP_TRANSFER_TYPE_ASCII
 Transfere o arquivo usando o método de transferência ASCII (Tipo A) do FTP. As informações de controle e formatação são convertidas em equivalentes locais.
FTP_TRANSFER_TYPE_BINARY
 Transfere o arquivo usando o método de transferência image (Tipo I) do FTP. O arquivo é transferido exatamente como existe sem alterações. Esse é o método de transferência padrão.
FTP_TRANSFER_TYPE_UNKNOWN
 O padrão é FTP_TRANSFER_TYPE_BINARY.
INTERNET_FLAG_TRANSFER_ASCII
 Transfere o arquivo como ASCII.
INTERNET_FLAG_TRANSFER_BINARY
 Transfere o arquivo como binário.
 

Os valores a seguir são usados para controlar o cache do arquivo. O aplicativo pode usar um ou mais dos valores a seguir.

Valor Significado
INTERNET_FLAG_HYPERLINK
 Força um recarregamento se não houver tempo expirado e nenhum tempo LastModified retornado do servidor ao determinar se o item deve ser recarregado da rede.
INTERNET_FLAG_NEED_FILE
 Faz com que um arquivo temporário seja criado se o arquivo não puder ser armazenado em cache.
INTERNET_FLAG_RELOAD
 Força um download do arquivo, objeto ou listagem de diretório solicitado do servidor de origem, não do cache.
INTERNET_FLAG_RESYNCHRONIZE
 Recarrega recursos HTTP se o recurso tiver sido modificado desde a última vez em que foi baixado. Todos os recursos de FTP são recarregados.

Windows XP e Windows Server 2003 R2 e versões anteriores: Os recursos gopher também são recarregados.

[in] dwContext

Ponteiro para uma variável que contém o valor definido pelo aplicativo que associa essa pesquisa a todos os dados do aplicativo. Esse parâmetro será usado somente se o aplicativo já tiver chamado InternetSetStatusCallback para configurar um retorno de chamada status.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter uma mensagem de erro específica, chame GetLastError.

Comentários

FtpPutFile é uma rotina de alto nível que manipula toda a contabilidade e sobrecarga associada à leitura de um arquivo localmente e ao armazená-lo em um servidor FTP. Um aplicativo que precisa enviar apenas dados de arquivo ou que exija um controle próximo sobre a transferência de arquivos deve usar as funções FtpOpenFile e InternetWriteFile .

Se o parâmetro dwFlagsespecificar FILE_TRANSFER_TYPE_ASCII, a tradução dos dados do arquivo converterá caracteres de controle e formatação em equivalentes locais.

LpszNewRemoteFile e lpszLocalFile podem ser nomes de arquivo parcial ou totalmente qualificados em relação ao diretório atual.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define FtpPutFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Sessões FTP

Funções WinINet