Funzione InternetQueryDataAvailable (wininet.h)

Esegue una query sul server per determinare la quantità di dati disponibili.

Sintassi

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

Parametri

[in] hFile

Handle restituito dalla funzione InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest .

[out] lpdwNumberOfBytesAvailable

Puntatore a una variabile che riceve il numero di byte disponibili. Può essere NULL.

[in] dwFlags

Questo parametro è riservato e deve essere 0.

[in] dwContext

Questo parametro è riservato e deve essere 0.

Valore restituito

Restituisce TRUE se la funzione ha esito positivo o FALSE in caso contrario. Per informazioni dettagliate sull'errore, chiamare GetLastError. Se la funzione non trova file corrispondenti, GetLastError restituisce ERROR_NO_MORE_FILES.

Commenti

Questa funzione restituisce il numero di byte di dati disponibili per essere letti immediatamente da una chiamata successiva a InternetReadFile. Se attualmente non sono disponibili dati e la fine del file non è stata raggiunta, la richiesta attende fino a quando i dati non diventano disponibili. La quantità di dati rimanenti non verrà ricalcolata finché non vengono letti tutti i dati disponibili indicati dalla chiamata a InternetQueryDataAvailable .

Per gli handle DELLA RETE GESTITA creati da HttpOpenRequest e inviati da HttpSendRequestEx, è necessario eseguire una chiamata a HttpEndRequest nell'handle prima che sia possibile usare InternetQueryDataAvailable .

Come tutti gli altri aspetti dell'API WinINet, questa funzione non può essere chiamata in modo sicuro da DllMain o dai costruttori e distruttori di oggetti globali.

Nota WinINet non supporta le implementazioni del server. Inoltre, non deve essere usato da un servizio. Per le implementazioni del server o i servizi, usare i servizi HTTP di Microsoft Windows (WinHTTP).

 

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wininet.h
Libreria	Wininet.lib
DLL	Wininet.dll

Vedi anche

Funzioni comuni

Funzioni WinINet