Fungsi WsReadType (webservices.h)

Artikel
03/03/2024

Baca nilai WS_TYPE yang diberikan dari XML sesuai dengan WS_TYPE_MAPPING.

Sintaks

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parameter

[in] reader

Pembaca yang diposisikan pada XML untuk deserialisasi.

[in] typeMapping

Menjelaskan bagaimana jenis memetakan ke XML yang sedang dibaca.

[in] type

Jenis nilai yang akan dideserialisasi.

[in, optional] typeDescription

Informasi tambahan tentang jenis tersebut. Setiap jenis memiliki struktur deskripsi yang berbeda. Ini mungkin NULL, tergantung pada WS_TYPE.

[in] readOption

Apakah nilai diperlukan, dan cara mengalokasikan nilai. Lihat WS_READ_OPTION untuk informasi selengkapnya.

Parameter ini harus memiliki salah satu nilai berikut:

[in, optional] heap

Timbunan untuk menyimpan nilai yang dideserialisasi.

value

Interpretasi parameter ini tergantung pada WS_READ_OPTION.

[in] valueSize

Interpretasi parameter ini tergantung pada WS_READ_OPTION.

[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
WS_E_INVALID_FORMAT	Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
E_OUTOFMEMORY	Kehabisan memori.
WS_E_QUOTA_EXCEEDED	Kuota ukuran tumpukan terlampaui.
E_INVALIDARG	Satu atau beberapa argumen tidak valid.

Keterangan

Lihat WS_TYPE_MAPPING cara menggunakan fungsi ini untuk membaca nilai dari elemen dan atribut.

Jika API gagal, status pembaca input menjadi tidak terdefinisi. Satu-satunya API yang dapat digunakan pada pembaca jika ini terjadi adalah WsSetInput dan WsSetInputToBuffer untuk mengembalikan pembaca ke keadaan yang dapat digunakan, atau WsFreeReader untuk membebaskan pembaca.

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