Expand Minimize

WsRemoveNode function

Removes the node at the specified position from the xml buffer. If positioned on an element it will remove the element including all of its children and its corresponding end element, otherwise it will remove a single node.

The use of any API with a WS_XML_READER or WS_XML_WRITER that currently depends on this position or a child of this position will fail. The WS_XML_READER or WS_XML_WRITER must be repositioned before using further.

It will return WS_E_INVALID_OPERATION if the node is positioned on an end element or the root of the document. (See Windows Web Services Return Values.)

Calling WsSetReaderPosition or WsSetWriterPosition after calling WsRemoveNode will fail.

Syntax


HRESULT WINAPI  WsRemoveNode(
  _In_      const WS_XML_NODE_POSITION* nodePosition,
  _In_opt_  WS_ERROR* error
);

Parameters

nodePosition [in]

The position of the node that should be removed.

error [in, optional]

Specifies where additional error information should be stored if the function fails.

Return value

This function can return one of these values.

Return codeDescription
WS_E_INVALID_OPERATION

The operation is not allowed due to the current state of the object.

 

Requirements

Minimum supported client

Windows 7 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2 [desktop apps | Windows Store apps]

Header

WebServices.h

Library

WebServices.lib

DLL

WebServices.dll

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.