Metode IXMLHTTPRequest2Callback::OnDataAvailable (msxml6.h)

Terjadi ketika klien menerima bagian dari data respons HTTP dari server.

Sintaks

HRESULT OnDataAvailable(
  [in, optional] IXMLHTTPRequest2  *pXHR,
  [in, optional] ISequentialStream *pResponseStream
);

Parameter

[in, optional] pXHR

Permintaan HTTP awal.

[in, optional] pResponseStream

Aliran respons yang diterima. Klien dapat memanggil ISequentialStream::Read untuk mulai memproses data, atau dapat menunggu hingga menerima respons lengkap. Aliran respons ini dibungkus dalam objek sinkronisasi aliran yang mencegah operasi baca dan tulis bersamaan, sehingga aplikasi tidak perlu menerapkan sinkronisasi kustom.

Nilai kembali

Mengembalikan S_OK pada keberhasilan.

Catatan Fungsi panggilan balik ini tidak boleh melemparkan pengecualian.

 

Keterangan

Ketika fungsi panggilan balik ini mengembalikan aplikasi dapat mulai memproses data dari respons HTTP, bahkan jika belum menerima seluruh respons. Namun, penerimaan ditangguhkan untuk permintaan sampai fungsi panggilan balik ini kembali. Selain itu, panggilan balik ini dapat dipanggil beberapa kali selama satu permintaan.

Fungsi panggilan balik ini tidak boleh memblokir dan tidak boleh dilakukan untuk melakukan operasi intensif sumber daya seperti pembaruan UI.

Aliran kustom menerima panggilan ke ISequentialStream::Write sebelum OnDataAvailable diaktifkan. Klien dapat memproses data langsung dari panggilan Tulis alih-alih memanggil ISequentialStream::Baca di aliran kustom, dan dapat mengandalkan panggilan Tulis untuk menunjukkan bahwa data baru tersedia.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop | Aplikasi UWP],MSXML 6.0 dan yang lebih baru
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	msxml6.h

Lihat juga

Antarmuka ISequentialStream

IXMLHTTPRequest2Callback