Fungsi WsFillReader (webservices.h)

Artikel
03/03/2024

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

Bagikan melalui