InternetQueryDataAvailable-Funktion (wininet.h)

Artikel
03/13/2024

Fragt den Server ab, um die menge der verfügbaren Daten zu bestimmen.

Syntax

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

Parameter

[in] hFile

Von der Funktion InternetOpenUrl, FtpOpenFile, GopherOpenFile oder HttpOpenRequest zurückgegebenes Handle.

[out] lpdwNumberOfBytesAvailable

Zeiger auf eine Variable, die die Anzahl der verfügbaren Bytes empfängt. Kann NULL sein.

[in] dwFlags

Dieser Parameter ist reserviert und muss 0 sein.

[in] dwContext

Dieser Parameter ist reserviert und muss 0 sein.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Wenn die Funktion keine übereinstimmenden Dateien findet, gibt GetLastError ERROR_NO_MORE_FILES zurück.

Hinweise

Diese Funktion gibt die Anzahl der Bytes an Daten zurück, die sofort durch einen nachfolgenden Aufruf von InternetReadFile gelesen werden können. Wenn derzeit keine Daten verfügbar sind und das Ende der Datei nicht erreicht wurde, wartet die Anforderung, bis Die Daten verfügbar sind. Die verbleibende Datenmenge wird erst dann neu berechnet, wenn alle verfügbaren Daten gelesen werden, die durch den Aufruf von InternetQueryDataAvailable angegeben werden.

Für HINTERNET-Handles , die von HttpOpenRequest erstellt und von HttpSendRequestEx gesendet werden, muss ein Aufruf von HttpEndRequest für das Handle erfolgen, bevor InternetQueryDataAvailable verwendet werden kann.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Allgemeine Funktionen

WinINet-Funktionen

Freigeben über