Windows apps
Collapse the table of content
Expand the table of content
Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

WS_XML_STRING structure

Represents a string that optionally has dictionary information associated with it. The xml APIs use WS_XML_STRINGs to identify prefixes, localNames and namespaces.

Syntax


struct WS_XML_STRING {
  ULONG              length;
  BYTE*              bytes;
  WS_XML_DICTIONARY* dictionary;
  ULONG              id;
};

Members

length

The number of bytes in the UTF-8 encoded representation of the string.

bytes

The string encoded as UTF-8 bytes.

dictionary

A pointer to the dictionary that contains the string. If the string is not part of a dictionary then the value may be NULL.

id

A value that uniquely identifies the string within the specified dictionary. The entry at dictionary->strings[id] should identify this string.

If the dictionary is NULL, then this value is unused.

Remarks

The string is represented as UTF-8 encoded bytes, not WCHARs. It is not required to be zero terminated.

The macros WS_XML_STRING_VALUE, WS_XML_STRING_NULL and WS_XML_STRING_DICTIONARY_VALUE can be used to initialize this structure.

The dictionary information is used by the binary encoding to write a more compact xml document.

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

 

 

Community Additions

Show:
© 2017 Microsoft