Metode IXMLHTTPRequest2Callback::OnResponseReceived (msxml6.h)

Artikel
02/29/2024

Terjadi ketika klien telah menerima respons lengkap dari server.

Sintaks

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

Parameter

[in, optional] pXHR

Objek permintaan HTTP awal

[in, optional] pResponseStream

Aliran respons yang diterima. Klien dapat memanggil ISequentialStream::Read untuk mulai memproses data, atau dapat menyimpan referensi ke pResponseStream untuk diproses nanti. 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 peristiwa ini mengaktifkan aplikasi dapat mulai memproses data dari respons HTTP. Pemrosesan dapat dimulai sebelum peristiwa ini diaktifkan jika peristiwa OnDataAvailable sebelumnya telah terjadi.

Kecuali OnError dipanggil, panggilan ke OnResponseReceived adalah panggilan balik akhir. Klien harus melakukan pembersihan yang diperlukan termasuk merilis referensi ke objek IXMLHTTPRequest2 .

Aliran kustom menerima panggilan ke ISequentialStream::Write yang menentukan 0 byte yang ditulis sebelum OnResponseReceived diaktifkan. Klien dapat memproses data langsung dari panggilan Tulis alih-alih memanggil ISequentialStream::Baca di aliran kustom, dan dapat mengandalkan panggilan Tulis nol byte untuk menunjukkan bahwa respons telah diterima.

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

Bagikan melalui