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
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_S_ASYNC	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