Fungsi WsReadType (webservices.h)
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 |
---|---|
|
Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan. |
|
Kehabisan memori. |
|
Kuota ukuran tumpukan terlampaui. |
|
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 |