Função InternetQueryDataAvailable (wininet.h)

  • Artigo

Consulta o servidor para determinar a quantidade de dados disponíveis.

Sintaxe

BOOL InternetQueryDataAvailable(
  [in]  HINTERNET hFile,
  [out] LPDWORD   lpdwNumberOfBytesAvailable,
  [in]  DWORD     dwFlags,
  [in]  DWORD_PTR dwContext
);

Parâmetros

[in] hFile

Identificador retornado pela função InternetOpenUrl, FtpOpenFile, GopherOpenFile ou HttpOpenRequest .

[out] lpdwNumberOfBytesAvailable

Ponteiro para uma variável que recebe o número de bytes disponíveis. Pode ser NULL.

[in] dwFlags

Esse parâmetro é reservado e deve ser 0.

[in] dwContext

Esse parâmetro é reservado e deve ser 0.

Retornar valor

Retornará TRUE se a função for bem-sucedida ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Se a função não encontrar arquivos correspondentes, GetLastError retornará ERROR_NO_MORE_FILES.

Comentários

Essa função retorna o número de bytes de dados que estão disponíveis para serem lidos imediatamente por uma chamada subsequente para InternetReadFile. Se atualmente não houver dados disponíveis e o final do arquivo não tiver sido atingido, a solicitação aguardará até que os dados fiquem disponíveis. A quantidade de dados restantes não será recalculada até que todos os dados disponíveis indicados pela chamada para InternetQueryDataAvailable sejam lidos.

Para identificadores HINTERNET criados por HttpOpenRequest e enviados por HttpSendRequestEx, uma chamada para HttpEndRequest deve ser feita no identificador antes que InternetQueryDataAvailable possa ser usada.

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).
 

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

Funções comuns

Funções WinINet