Fungsi WsReadCharsUtf8 (webservices.h)

Artikel
03/13/2024

Membaca jumlah karakter teks tertentu dari pembaca dan mengembalikannya yang dikodekan dalam UTF-8.

Sintaks

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Penunjuk ke Pembaca XML tempat data karakter harus dibaca. Penunjuk harus mereferensikan objek WS_XML_READER yang valid.

bytes

Penunjuk ke buffer untuk menempatkan byte yang dikodekan yang telah dibaca.

[in] maxByteCount

Jumlah maksimum byte yang harus dibaca.

[out] actualByteCount

Penunjuk ke nilai ULONG dari jumlah byte aktual yang dibaca. Ini mungkin kurang dari maxByteCount bahkan ketika ada lebih banyak byte yang tersisa. Tidak ada lagi byte ketika ini mengembalikan nol.

[in, optional] error

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

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_QUOTA_EXCEEDED	Kuota terlampaui.

Keterangan

Teks XML dibaca hingga elemen mulai atau elemen akhir. Komentar dilewati, dan konten CDATA diperlakukan identik dengan konten elemen. Entitas karakter dikonversi ke bentuknya yang tidak dilewati.

Fungsi ini dapat gagal karena salah satu alasan yang tercantum dalam WsReadNode.

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