WS_XML_STRING-Struktur (webservices.h)

Stellt eine Zeichenfolge dar, der optional Wörterbuchinformationen zugeordnet sind. Die XML-APIs verwenden WS_XML_STRINGs, um Präfixe, localNames und Namespaces zu identifizieren.

Syntax

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

Member

length

Die Anzahl der Bytes in der UTF-8-codierten Darstellung der Zeichenfolge.

bytes

Die als UTF-8-Bytes codierte Zeichenfolge.

dictionary

Ein Zeiger auf das Wörterbuch, das die Zeichenfolge enthält. Wenn die Zeichenfolge nicht Teil eines Wörterbuchs ist, kann der Wert NULL sein.

id

Ein -Wert, der die Zeichenfolge innerhalb des angegebenen Wörterbuchs eindeutig identifiziert. Der Eintrag unter dictionary-strings>[id] sollte diese Zeichenfolge identifizieren.

Wenn das Wörterbuch NULL ist, wird dieser Wert nicht verwendet.

Hinweise

Die Zeichenfolge wird als UTF-8-codierte Bytes dargestellt, nicht als WCHARs. Es ist nicht erforderlich, dass 0 (null) beendet wird.

Die Makros WS_XML_STRING_VALUE, WS_XML_STRING_NULL und WS_XML_STRING_DICTIONARY_VALUE können verwendet werden, um diese Struktur zu initialisieren.

Die Wörterbuchinformationen werden von der binären Codierung verwendet, um ein kompaktes XML-Dokument zu schreiben.

Anforderungen