Fungsi WsFillReader (webservices.h)
Memastikan bahwa pembaca telah menyangga jumlah byte minimum data XML untuk digunakan oleh fungsi pembaca berikutnya. Ini akan memanggil panggilan balik yang ditentukan oleh WS_XML_READER_STREAM_INPUT sebanyak yang diperlukan untuk mendapatkan jumlah byte yang ditentukan oleh nilai parameter minSize . Setelah selesai, data yang di-buffer tersedia untuk fungsi pembaca lain. Jika fungsi pembaca berikutnya memerlukan lebih banyak data daripada yang telah diperoleh, fungsi akan mengembalikan pengecualian WS_E_QUOTA_EXCEEDED . (Lihat Nilai Pengembalian Windows Web Services.)
Sintaks
HRESULT WsFillReader(
[in] WS_XML_READER *reader,
[in] ULONG minSize,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parameter
[in] reader
Penunjuk ke struktur WS_XML_READER yang digunakan untuk mendapatkan data.
[in] minSize
Menentukan jumlah minimum byte yang harus diperoleh pembaca. Jika jumlah byte saat ini di-buffer sama dengan atau lebih besar dari nilai minSize , fungsi tidak akan melakukan apa pun dan akan segera kembali.
[in, optional] asyncContext
Penunjuk ke struktur data WS_ASYNC_CONTEXT dengan informasi tentang memanggil fungsi secara asinkron. Nilai NULL menunjukkan permintaan untuk operasi sinkron.
[in, optional] error
Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.
Mengembalikan nilai
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Operasi asinkron masih tertunda. |
Keterangan
Jumlah byte yang diperlukan untuk membaca segmen data XML tertentu tergantung pada pengodean dan pemformatannya.
Fungsi ini adalah "no-op" ketika digunakan dengan pembaca menggunakan WS_XML_READER_BUFFER_INPUT.
Dengan menentukan WS_ASYNC_CONTEXT data dibaca secara asinkron.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 7 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2008 R2 [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | webservices.h |
Pustaka | WebServices.lib |
DLL | WebServices.dll |