Fungsi WsPushBytes (webservices.h)

Artikel
03/15/2023

Menetapkan panggilan balik yang akan dipanggil untuk menulis byte dalam elemen. Dalam beberapa pengodean ini bisa lebih efisien dengan menghilangkan salinan data.

Sintaks

HRESULT WsPushBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PUSH_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] writer

Penunjuk ke objek Penulis XML tempat byte ditulis. Penunjuk harus mereferensikan WS_XML_WRITER yang valid dan nilai yang dirujuk mungkin bukan NULL.

[in] callback

Parameter ini adalah panggilan balik untuk dipanggil untuk menulis data.

[in, optional] callbackState

Penunjuk ke status yang ditentukan pengguna yang diteruskan ke fungsi panggilan balik.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Nilai kembali

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_E_INVALID_OPERATION	Operasi tidak diperbolehkan karena status objek saat ini.

Keterangan

Saat menulis dengan WS_XML_WRITER_MTOM_ENCODING, WsPushBytes menyediakan cara untuk menulis byte langsung ke bagian MIME sendiri dan menghindari salinan. Namun, penulis atas kebijakannya, dapat memilih untuk segera memanggil panggilan balik, sehingga pemanggil harus siap untuk ini.

Jika pengodean tidak dapat memanfaatkan perilaku ini, maka WsPushBytes akan segera memanggil panggilan balik dan beroperasi seolah-olah WsWriteBytes dipanggil.

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

Bagikan melalui