Fungsi WsReadChars (webservices.h)

Artikel
08/27/2023

Membaca jumlah karakter teks tertentu dari Pembaca.

Sintaks

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [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.

chars

Penunjuk ke lokasi untuk karakter yang telah dibaca.

[in] maxCharCount

Jumlah maksimum karakter yang harus dibaca.

[out] actualCharCount

Penunjuk ke nilai ULONG dari jumlah karakter aktual yang dibaca. Ini mungkin kurang dari maxCharCount bahkan ketika ada lebih banyak karakter yang tersisa. Tidak ada lagi karakter 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 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