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