Fungsi WsReadNode (webservices.h)

  • Artikel

Operasi ini memajukan Pembaca ke simpul berikutnya di aliran input. Jika ada kesalahan saat mengurai input, fungsi akan mengembalikan WS_E_INVALID_FORMAT. (Lihat Nilai Pengembalian Windows Web Services.)

Sintaks

HRESULT WsReadNode(
  [in]           WS_XML_READER *reader,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Penunjuk ke objek Pembaca XML untuk maju. Penunjuk harus mereferensikan WS_XML_READER yang valid dan mungkin bukan NULL.

[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, atau beberapa elemen tingkat atas ditemukan dan WS_XML_READER_PROPERTY_ALLOW_FRAGMENTfalse.
WS_E_QUOTA_EXCEEDED
 Elemen dibaca yang melebihi beberapa batas seperti WS_XML_READER_PROPERTY_MAX_DEPTH atau WS_XML_READER_PROPERTY_MAX_ATTRIBUTES.

Keterangan

Kondisi pengecualian lainnya meliputi:

  • Jika deklarasi XML ditemukan dan WS_XML_READER_PROPERTY_READ_DECLARATIONFALSE, WS_E_INVALID_FORMAT dikembalikan.
  • Jika Pembaca menggunakan WS_XML_READER_STREAM_INPUT dan tidak ada cukup data yang di-buffer pembaca akan mengembalikan WS_E_QUOTA_EXCEEDED.

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