Поделиться через


Функция WsRemoveNode (webservices.h)

Удаляет узел в указанной позиции из xml-буфера. Если он расположен на элементе, он удаляет элемент, включая все его дочерние элементы и соответствующий конечный элемент, в противном случае удаляется один узел.

Использование любого API с WS_XML_READER или WS_XML_WRITER , которые в настоящее время зависят от этой позиции или дочернего элемента этой позиции, завершится ошибкой. Перед дальнейшим использованием необходимо изменить положение WS_XML_READER или WS_XML_WRITER.

Он вернет WS_E_INVALID_OPERATION , если узел расположен в конце элемента или корне документа. (См. раздел Возвращаемые значения веб-служб Windows.)

Вызов WsSetReaderPosition или WsSetWriterPosition после вызова WsRemoveNode завершится ошибкой .

Синтаксис

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

Параметры

[in] nodePosition

Положение узла, который следует удалить.

[in, optional] error

Указывает, где должны храниться дополнительные сведения об ошибке в случае сбоя функции.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата Описание
WS_E_INVALID_OPERATION
Операция не разрешена из-за текущего состояния объекта .

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll