Fungsi WsMoveReader (webservices.h)

  • Artikel

Memindahkan posisi pembaca saat ini seperti yang ditentukan oleh parameter moveTo .

Fungsi ini hanya dapat digunakan pada pembaca yang diatur ke XmlBuffer.

Sintaks

HRESULT WsMoveReader(
  [in]           WS_XML_READER *reader,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] reader

Penunjuk ke objek Pembaca XML dengan posisi untuk dipindahkan. Penunjuk harus mereferensikan objek WS_XML_READER yang valid dan nilai Pembaca yang dirujuk mungkin bukan NULL.

[in] moveTo

Enumerator ini menentukan arah atau posisi pembaca berikutnya relatif terhadap posisi saat ini.

found

Menunjukkan keberhasilan atau kegagalan pemindahan yang ditentukan.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Menampilkan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
E_INVALIDARG
 Satu atau beberapa argumen tidak valid.
WS_E_INVALID_FORMAT
 Data input tidak dalam format yang diharapkan atau tidak memiliki nilai yang diharapkan.
WS_E_INVALID_OPERATION
 Operasi tidak diperbolehkan karena status objek saat ini.

Keterangan

Jika parameter yang ditemukan bukan NULL, maka parameter tersebut akan menunjukkan apakah parameter tersebut dapat berpindah ke node yang diminta atau tidak dan mengembalikan NOERROR.

Jika parameter yang ditemukan adalah NULL, dan simpul yang diminta tidak ditemukan, parameter tersebut akan mengembalikan WS_E_INVALID_FORMAT. (Lihat Nilai Pengembalian Windows Web Services.)

Fungsi ini tidak dapat digunakan saat melakukan kanonikalisasi. Jika WsStartReaderCanonicalization telah dipanggil, WsStartReaderCanonicalization akan mengembalikan WS_E_INVALID_OPERATION.

Persyaratan

   
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