Fungsi InternetQueryDataAvailable (wininet.h)

  • Artikel

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.

Catatan WinINet tidak mendukung implementasi server. Selain itu, itu tidak boleh digunakan dari layanan. Untuk implementasi atau layanan server, gunakan Microsoft Windows HTTP Services (WinHTTP).
 

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

Lihat juga

Fungsi Umum

Fungsi WinINet