Fungsi WsReadXmlBufferFromBytes (webservices.h)

Artikel
03/03/2024

Menggunakan pembaca untuk mengonversi sekumpulan byte yang dikodekan ke WS_XML_BUFFER.

Sintaks

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

Parameter

[in] reader

Pembaca yang digunakan untuk mengurai byte yang dikodekan.

[in, optional] encoding

Pengodean yang digunakan saat mengurai byte. Jika NULL, WS_XML_READER_TEXT_ENCODING dengan set karakter WS_CHARSET_AUTO akan digunakan.

properties

Array properti opsional pembaca. Lihat WS_XML_READER_PROPERTY.

[in] propertyCount

Jumlah properti.

bytes

Byte yang akan diurai.

[in] byteCount

Jumlah byte yang akan diurai.

[in] heap

Timbunan untuk mengalokasikan buffer XML.

xmlBuffer

Buffer XML tempat byte dibaca dikembalikan di sini.

[in, optional] error

Menentukan tempat 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 mengurai seluruh konten sesuai dengan pengodean yang ditentukan dan menyimpannya ke dalam WS_XML_BUFFER.

Pembaca akan dibiarkan dalam keadaan tidak terdefinisi setelah memanggil fungsi ini. Namun, WsReadXmlBufferFromBytes dapat digunakan lagi dengan pembaca seperti itu. Jika tidak, WsSetInput atau WsSetInputToBuffer harus digunakan untuk membawa pembaca kembali ke keadaan yang diketahui, atau pembaca harus dibebaskan menggunakan WsFreeReader.

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