Fungsi WsMoveWriter (webservices.h)

  • Artikel

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

Sintaks

HRESULT WsMoveWriter(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_MOVE_TO    moveTo,
                 BOOL          *found,
  [in, optional] WS_ERROR      *error
);

Parameter

[in] writer

Penulis yang akan dipindahkan.

[in] moveTo

Posisi relatif untuk memindahkan penulis.

found

Jika ini non-NULL, maka apakah posisi baru dapat dipindahkan atau tidak dikembalikan di sini.

Jika ini NULL, dan posisi tidak dapat dipindahkan, maka fungsi akan mengembalikan WS_E_INVALID_FORMAT. (Lihat Nilai Pengembalian Windows Web Services.)

[in, optional] error

Menentukan di mana informasi kesalahan tambahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

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

Keterangan

Ini hanya dapat digunakan pada penulis yang diatur ke WS_XML_BUFFER.

Jika parameter yang ditemukan bukan NULL, maka parameter tersebut akan menunjukkan di sana 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.

Setelah diposisikan, penulis kemudian akan menyisipkan data baru sebelum posisi yang ditentukan.

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