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

Статья
08/27/2023

Удаляет узел в указанной позиции из 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

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