Edit

Share via

WS_XML_READER_PROPERTY_ID enumeration (webservices.h)

  • Article

Identifies each XML reader property is and its associated value. This enumeration is used within the WS_XML_READER_PROPERTY structure, which is used as a parameter to WsCreateReader, WsSetInput, WsSetInputToBuffer, and WsReadXmlBufferFromBytes. It is also used directly as a parameter to WsGetReaderProperty.

Syntax

typedef enum {
  WS_XML_READER_PROPERTY_MAX_DEPTH = 0,
  WS_XML_READER_PROPERTY_ALLOW_FRAGMENT = 1,
  WS_XML_READER_PROPERTY_MAX_ATTRIBUTES = 2,
  WS_XML_READER_PROPERTY_READ_DECLARATION = 3,
  WS_XML_READER_PROPERTY_CHARSET = 4,
  WS_XML_READER_PROPERTY_ROW = 5,
  WS_XML_READER_PROPERTY_COLUMN = 6,
  WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE = 7,
  WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE = 8,
  WS_XML_READER_PROPERTY_IN_ATTRIBUTE = 9,
  WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE = 10,
  WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE = 11,
  WS_XML_READER_PROPERTY_MAX_MIME_PARTS = 12,
  WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES = 13,
  WS_XML_READER_PROPERTY_MAX_NAMESPACES = 14
} WS_XML_READER_PROPERTY_ID;

Constants

 
WS_XML_READER_PROPERTY_MAX_DEPTH
Value: 0
A ULONG that specifies the maximum depth of the document that the reader will permit.


Depth is measured at any point by the number of nested start elements.


A depth of 0 prevents any start elements from being read.


This property defaults to 32.


See WsCreateReader for security considerations.
WS_XML_READER_PROPERTY_ALLOW_FRAGMENT
Value: 1
A BOOL that
specifies whether the reader will permit multiple elements and non-white space at the top level of the document. This property
may not be set to TRUE with WS_XML_READER_MTOM_ENCODING.


This property defaults to FALSE.
WS_XML_READER_PROPERTY_MAX_ATTRIBUTES
Value: 2
A ULONG that specifies the maximum number of attributes the reader will permit on an element.


This property defaults to 128.


See WsCreateReader for security considerations.
WS_XML_READER_PROPERTY_READ_DECLARATION
Value: 3
A BOOL that specifies if the reader should permit an xml declaration at the start of the document.


This property defaults to TRUE.
WS_XML_READER_PROPERTY_CHARSET
Value: 4
A WS_CHARSET value that returns the character set of the xml document. This value is only available for
text documents.


If the reader was initialized with a WS_CHARSET_AUTO then it will automatically determine this
value. The reader input source is streamed, then the reader must have enough data buffered to be able to
inspect initial byte order marks and the xml declaration. See WsFillReader.


If the reader was initialized with any other value, then this property simply returns that value.
WS_XML_READER_PROPERTY_ROW
Value: 5
A ULONGLONG that returns the 0 based row number of the node the reader is positioned on for text xml documents.
WS_XML_READER_PROPERTY_COLUMN
Value: 6
A ULONGLONG that returns the 0 based column number of the node the reader is positioned on for text xml documents.
WS_XML_READER_PROPERTY_UTF8_TRIM_SIZE
Value: 7
A ULONG that specifies the trim size of the internal buffer used by the
WS_XML_READER for performing UTF-16 to UTF-8 conversions. Increasing this value
uses more memory, but can reduce allocations when processing UTF-16 encoded documents.


This property defaults to 4096.
WS_XML_READER_PROPERTY_STREAM_BUFFER_SIZE
Value: 8
A ULONG that specifies the size of the buffer the WS_XML_READER will use when configured to use
WS_XML_READER_STREAM_INPUT. Increasing this value uses more memory, but
can reduce the number of times the WS_READ_CALLBACK is invoked.


This property defaults to 4096.
WS_XML_READER_PROPERTY_IN_ATTRIBUTE
Value: 9
Indicates that WsReadStartAttribute has been called and the reader is
positioned on attribute content.
WS_XML_READER_PROPERTY_STREAM_MAX_ROOT_MIME_PART_SIZE
Value: 10
A ULONG used with WS_XML_READER_STREAM_INPUT in conjunction with WS_XML_READER_MTOM_ENCODING.
This value specifies the maximum size of the root MIME part, which is the part that contains
the xml portion of the document. It has no effect when used with other encodings, or when used with
WS_XML_READER_BUFFER_INPUT.


This property defaults to 65536.
WS_XML_READER_PROPERTY_STREAM_MAX_MIME_HEADERS_SIZE
Value: 11
A ULONG used with WS_XML_READER_STREAM_INPUT in conjunction with WS_XML_READER_MTOM_ENCODING.
This value specifies the maximum size of any group of MIME headers that may appear in the document.
It has no effect when used with other encodings, or when used with WS_XML_READER_BUFFER_INPUT.


This property defaults to 256.
WS_XML_READER_PROPERTY_MAX_MIME_PARTS
Value: 12
A ULONG used with WS_XML_READER_MTOM_ENCODING. This value specifies the maximum number of MIME parts
that may appear in the document. It has no effect when used with other encodings.


This property defaults to 4096.
WS_XML_READER_PROPERTY_ALLOW_INVALID_CHARACTER_REFERENCES
Value: 13
A BOOL used with WS_XML_READER_TEXT_ENCODING. Setting this to TRUE permits character references
of characters considered invalid by XML 1.0 to be accepted.


Setting this property to TRUE may affect interoperability.


This property defaults to FALSE.
WS_XML_READER_PROPERTY_MAX_NAMESPACES
Value: 14
A ULONG that specifies the maximum number of xmlns unique declarations that may appear in scope at any point
while reading the document.


This property defaults to 32.


See WsCreateReader for security considerations.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Header webservices.h