Fungsi WsReadChars (webservices.h)

  • Artikel
  • 2 menit untuk membaca

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.

Nilai kembali

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

   
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