Bagikan melalui

Fungsi WsRemoveNode (webservices.h)

  • Artikel

Menghapus simpul pada posisi yang ditentukan dari buffer xml. Jika diposisikan pada elemen, elemen tersebut akan menghapus elemen termasuk semua turunannya dan elemen akhir yang sesuai, jika tidak, elemen tersebut akan menghapus satu simpul.

Penggunaan API apa pun dengan WS_XML_READER atau WS_XML_WRITER yang saat ini bergantung pada posisi ini atau anak dari posisi ini akan gagal. WS_XML_READER atau WS_XML_WRITER harus diposisikan ulang sebelum menggunakan lebih lanjut.

Ini akan mengembalikan WS_E_INVALID_OPERATION jika simpul diposisikan pada elemen akhir atau akar dokumen. (Lihat Nilai Pengembalian Windows Web Services.)

Memanggil WsSetReaderPosition atau WsSetWriterPosition setelah memanggil WsRemoveNode akan gagal.

Sintaks

HRESULT WsRemoveNode(
  [in]           const WS_XML_NODE_POSITION *nodePosition,
  [in, optional] WS_ERROR                   *error
);

Parameter

[in] nodePosition

Posisi simpul yang harus dihapus.

[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_OPERATION
 Operasi tidak diperbolehkan karena status objek saat ini.

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