Fungsi WsReadArray (webservices.h)

  • Artikel

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
WS_E_INVALID_FORMAT
 Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_QUOTA_EXCEEDED
 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