Fungsi WsWriteBytes (webservices.h)

Artikel
03/03/2024

Menulis byte ke penulis dalam format yang dioptimalkan untuk pengodean. Saat menulis dalam pengodean teks, itu akan memancarkan byte yang dikodekan dalam base64. Saat menulis ke format biner, itu akan memancarkan byte secara langsung.

Sintaks

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Penulis tempat byte akan ditulis.

bytes

Byte untuk menulis ke dokumen.

[in] byteCount

Jumlah byte yang akan ditulis ke dokumen.

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

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.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.

Keterangan

WsWriteBytes dapat dipanggil lebih dari sekali antara WsWriteStartAttribute dan WsWriteEndAttribute. Ini mungkin tidak dikombinasikan dengan WsWriteChars, WsWriteCharsUtf8, WsWriteValue atau WsWriteText saat menulis atribut.

Untuk WS_XML_WRITER_MTOM_ENCODING, jika byteCount melebihi maxInlineByteCount yang ditentukan selama WsSetOutput , byte akan di-buffer dan ditempatkan di bagian MIME mereka sendiri. Jika tidak, byte dikodekan di base64 dan ditempatkan langsung dalam dokumen.

Untuk WS_XML_WRITER_MTOM_ENCODING, jika elemen yang berisi byte memiliki atribut dengan nama 'contentType' dan namespace 'http://www.w3.org/2004/11/xmlmime', maka nilai atribut akan tercermin dalam header jenis konten untuk bagian MIME seperti yang dijelaskan dalam Xml-binary Optimized Packaging.

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