WS_XML_NODE_POSITION structure (webservices.h)

Represents a position within an XML buffer. The current position within a reader or writer may be obtained by calling WsGetReaderPosition or WsGetWriterPosition. The current position within a reader or writer may be set by calling WsSetReaderPosition or WsSetWriterPosition.

Using WsRemoveNode to remove a node that corresponds to or contains a position will cause subsequent use of the position to fail. The position itself remains valid, but operations that depend on that position will fail.

Positions may be used as long as the containing XML buffer is valid. Using a position after its corresponding buffer has been deleted will exhibit undefined behavior.

Syntax

typedef struct _WS_XML_NODE_POSITION {
  WS_XML_BUFFER *buffer;
  void          *node;
} WS_XML_NODE_POSITION;

Members

buffer

The xml buffer to which the position refers.

node

An internal handle to the node.

Requirements