Fungsi WsWriteXmlBufferToBytes (webservices.h)

Artikel
03/03/2024

Menggunakan penulis untuk mengonversi WS_XML_BUFFER ke sekumpulan byte yang dikodekan.

Sintaks

HRESULT WsWriteXmlBufferToBytes(
  [in]           WS_XML_WRITER                *writer,
  [in]           WS_XML_BUFFER                *xmlBuffer,
  [in, optional] const WS_XML_WRITER_ENCODING *encoding,
                 const WS_XML_WRITER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
  [in]           WS_HEAP                      *heap,
                 void                         **bytes,
  [out]          ULONG                        *byteCount,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] writer

Penulis yang digunakan untuk menghasilkan byte yang dikodekan.

[in] xmlBuffer

Buffer XML yang akan ditulis.

[in, optional] encoding

Pengodean yang digunakan saat menghasilkan byte. Jika NULL, byte akan dikodekan dalam utf8.

properties

Array properti opsional penulis. Lihat WS_XML_WRITER_PROPERTY.

[in] propertyCount

Jumlah properti.

[in] heap

Timbunan dari mana mengalokasikan byte.

bytes

Byte yang dihasilkan dikembalikan di sini.

[out] byteCount

Jumlah byte yang dihasilkan dikembalikan di sini.

[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

Fungsi ini akan menghasilkan seluruh konten WS_XML_BUFFER sebagai sekumpulan byte linier yang dialokasikan dari tumpukan yang ditentukan dalam pengodean yang ditentukan.

Penulis akan dibiarkan dalam status tidak terdefinisi setelah memanggil fungsi ini. Namun, WsWriteXmlBufferToBytes dapat digunakan lagi dengan penulis seperti itu. Jika tidak, WsSetOutput atau WsSetOutputToBuffer harus digunakan untuk membawa penulis kembali ke keadaan yang diketahui, atau penulis harus dikosongkan menggunakan WsFreeWriter.

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