Função InternetQueryDataAvailable (wininet.h)

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.

Requisitos

Confira também

Funções comuns

Funções WinINet