Fungsi InternetQueryDataAvailable (wininet.h)
Mengkueri server untuk menentukan jumlah data yang tersedia.
Sintaks
BOOL InternetQueryDataAvailable(
[in] HINTERNET hFile,
[out] LPDWORD lpdwNumberOfBytesAvailable,
[in] DWORD dwFlags,
[in] DWORD_PTR dwContext
);
Parameter
[in] hFile
Menangani yang dikembalikan oleh fungsi InternetOpenUrl, FtpOpenFile, GopherOpenFile, atau HttpOpenRequest .
[out] lpdwNumberOfBytesAvailable
Penunjuk ke variabel yang menerima jumlah byte yang tersedia. Mungkin NULL.
[in] dwFlags
Parameter ini dicadangkan dan harus 0.
[in] dwContext
Parameter ini dicadangkan dan harus 0.
Nilai kembali
Mengembalikan TRUE jika fungsi berhasil, atau FALSE sebaliknya. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. Jika fungsi tidak menemukan file yang cocok, GetLastError mengembalikan ERROR_NO_MORE_FILES.
Keterangan
Fungsi ini mengembalikan jumlah byte data yang tersedia untuk segera dibaca dengan panggilan berikutnya ke InternetReadFile. Jika saat ini tidak ada data yang tersedia dan akhir file belum tercapai, permintaan menunggu hingga data tersedia. Jumlah data yang tersisa tidak akan dihitung ulang sampai semua data yang tersedia yang ditunjukkan oleh panggilan ke InternetQueryDataAvailable dibaca.
Untuk handel HINTERNET yang dibuat oleh HttpOpenRequest dan dikirim oleh HttpSendRequestEx, panggilan ke HttpEndRequest harus dilakukan pada handel sebelum InternetQueryDataAvailable dapat digunakan.
Seperti semua aspek lain dari Api WinINet, fungsi ini tidak dapat dipanggil dengan aman dari dalam DllMain atau konstruktor dan destruktor objek global.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | wininet.h |
Pustaka | Wininet.lib |
DLL | Wininet.dll |