Fungsi WsReadArray (webservices.h)
Membaca serangkaian elemen dari pembaca dan menginterpretasikan kontennya sesuai dengan jenis nilai yang ditentukan.
Sintaks
HRESULT WsReadArray(
[in] WS_XML_READER *reader,
[in] const WS_XML_STRING *localName,
[in] const WS_XML_STRING *ns,
[in] WS_VALUE_TYPE valueType,
void *array,
[in] ULONG arraySize,
[in] ULONG itemOffset,
[in] ULONG itemCount,
[out] ULONG *actualItemCount,
[in, optional] WS_ERROR *error
);
Parameter
[in] reader
Pembaca dari mana array harus dibaca.
[in] localName
LocalName dari elemen berulang.
[in] ns
Namespace dari elemen berulang.
[in] valueType
Jenis nilai yang digunakan untuk mengurai konten setiap elemen.
array
Array untuk diisi dengan nilai yang diurai. Ukuran item array ditentukan oleh jenis nilai. Lihat WS_VALUE_TYPE untuk informasi selengkapnya.
[in] arraySize
Ukuran dalam byte (bukan item) dari array.
[in] itemOffset
Offset item (bukan byte) dalam array untuk dibaca.
[in] itemCount
Jumlah item (bukan byte) yang akan dibaca ke dalam array.
[out] actualItemCount
Jumlah item aktual yang dibaca. Ini mungkin kurang dari itemCount bahkan ketika ada lebih banyak item yang tersisa. Tidak ada lagi elemen ketika ini mengembalikan nol.
[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. |
|
Kuota terlampaui. |
Keterangan
Fungsi ini secara semantik setara dengan menggunakan WsReadStartElement, WsReadValue dan WsReadEndElement dalam perulangan, tetapi lebih efisien.
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 |