WsSetReaderPosition function

Sets the current position of the Reader. The position must have been obtained by a call to WsGetReaderPosition or WsGetWriterPosition. This function can only be used on a reader that is set to a WS_XML_BUFFER.

Syntax

HRESULT WINAPI  WsSetReaderPosition(
  _In_     WS_XML_READER*              reader,
  _In_     const WS_XML_NODE_POSITION* nodePosition,
  _In_opt_ WS_ERROR*                   error
);

Parameters

reader [in]

A pointer to the WS_XML_READER object for which the current position is set. The pointer must reference a valid XML Reader object.

nodePosition [in]

A pointer to the position to set the Reader.

error [in, optional]

A pointer to a WS_ERROR object where additional information about the error should be stored if the function fails.

Return value

This function can return one of these values.

Remarks

See WS_XML_NODE_POSITION for more information on using positions.

This function cannot be used while canonicalizing. If WsStartReaderCanonicalization has been called, then it will return WS_E_INVALID_OPERATION. (See Windows Web Services Return Values.)

Requirements