Fungsi WsMoveWriter (webservices.h)

Artikel
03/09/2024

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

Bagikan melalui