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