Fungsi WsFlushWriter (webservices.h)
Menginstruksikan penulis untuk memanggil panggilan balik yang ditentukan dalam WS_XML_WRITER_STREAM_OUTPUT jika data yang memadai telah di-buffer.
Sintaks
HRESULT WsFlushWriter(
[in] WS_XML_WRITER *writer,
[in] ULONG minSize,
[in, optional] const WS_ASYNC_CONTEXT *asyncContext,
[in, optional] WS_ERROR *error
);
Parameter
[in] writer
Penulis untuk menyiram.
[in] minSize
Menentukan jumlah minimum byte yang harus di-buffer agar panggilan balik dipanggil. Jika kurang dari jumlah byte ini di-buffer, maka panggilan balik tidak akan dipanggil. Ini dapat digunakan untuk meminimalkan jumlah i/o yang terjadi saat menulis data dalam jumlah kecil.
Nol harus ditentukan untuk menjamin bahwa panggilan balik dipanggil.
[in, optional] asyncContext
Informasi tentang cara memanggil fungsi secara asinkron, atau NULL jika memanggil secara sinkron.
[in, optional] error
Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.
Menampilkan nilai
Fungsi ini dapat mengembalikan salah satu nilai ini.
Menampilkan kode | Deskripsi |
---|---|
|
Satu atau beberapa argumen tidak valid. |
|
Operasi asinkron masih tertunda. |
Keterangan
Penulis menyangga semua data sampai WsFlushWriter dipanggil.
Jika perlu, WsFlushWriter harus dipanggil sebelum WsFreeWriter untuk menjamin semua data dikeluarkan.
Dengan menentukan WS_ASYNC_CONTEXT data yang di-buffer akan ditulis secara asinkron.
Fungsi ini adalah no-op jika penulis menggunakan WS_XML_WRITER_BUFFER_OUTPUT.
Jika WsWriteStartElement telah dipanggil, tetapi elemen belum diterapkan (lihat WsWriteStartElement) maka elemen ini tidak akan dihapus.
Jika fungsi ini dipanggil saat menggunakan WS_XML_WRITER_MTOM_ENCODING dan tidak ada elemen terbuka pada penulis, maka bagian MIME pendukung akan dihasilkan dan dipancarkan. Setelah ini terjadi, API apa pun yang mencoba menulis lebih lanjut ke dokumen XML akan mengembalikan WS_E_INVALID_OPERATION. (Lihat Nilai Pengembalian Windows Web Services.)
Persyaratan
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 |