Função InternetWriteFile (wininet.h)

Grava dados em um arquivo de Internet aberto.

Sintaxe

BOOL InternetWriteFile(
  [in]  HINTERNET hFile,
  [in]  LPCVOID   lpBuffer,
  [in]  DWORD     dwNumberOfBytesToWrite,
  [out] LPDWORD   lpdwNumberOfBytesWritten
);

Parâmetros

[in] hFile

Identificador retornado de uma chamada anterior para FtpOpenFile ou um identificador HINTERNET enviado por HttpSendRequestEx.

[in] lpBuffer

Ponteiro para um buffer que contém os dados a serem gravados no arquivo.

[in] dwNumberOfBytesToWrite

Número de bytes a serem gravados no arquivo.

[out] lpdwNumberOfBytesWritten

Ponteiro para uma variável que recebe o número de bytes gravados no arquivo. InternetWriteFile define esse valor como zero antes de fazer qualquer verificação de erro ou trabalho.

Valor retornado

Retorna TRUE se a função for bem-sucedida ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Um aplicativo também pode usar InternetGetLastResponseInfo quando necessário.

Comentários

Quando o aplicativo está enviando dados, ele deve chamar InternetCloseHandle para encerrar a transferência de dados.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro do 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 ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

 

Requisitos

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

Funções comuns

Funções WinINet