Freigeben über

WS_XML_DICTIONARY-Struktur (webservices.h)

  • Artikel

Stellt einen Satz eindeutiger Zeichenfolgen dar. Diese Informationen werden von der binären Codierung verwendet, um ein kompaktes XML-Dokument zu schreiben.

Syntax

typedef struct _WS_XML_DICTIONARY {
  GUID          guid;
  WS_XML_STRING *strings;
  ULONG         stringCount;
  BOOL          isConst;
} WS_XML_DICTIONARY;

Member

guid

Eine GUID, die den Satz von Zeichenfolgen eindeutig identifiziert, die durch das Wörterbuch dargestellt werden. Die GUID wird nie übertragen oder beibehalten und muss nur für die Lebensdauer des Prozesses eindeutig sein.

strings

Der Satz eindeutiger Zeichenfolgen, aus denen das Wörterbuch besteht.

stringCount

Gibt die Anzahl der Zeichenfolgen im Wörterbuch an.

isConst

Gibt an, ob das Wörterbuch und sein Inhalt als const deklariert sind und dass sie für die gesamte Lebensdauer eines Objekts gültig bleiben, mit dem Zeichenfolgen im Wörterbuch verwendet werden.

Wenn dies TRUE ist, können die Zeichenfolgen effizienter bearbeitet werden.

Hinweise

Alle Zeichenfolgen und Werte innerhalb eines Wörterbuchs müssen eindeutig sein. Wörterbücher werden immer als wohlgeformt angenommen, daher ist es Sache des Erstellers des Wörterbuchs, sicherzustellen, dass dies der Fall ist.

Ein Wörterbuch kann wie folgt deklariert werden:

struct PurchaseOrderDictionary
{
    WS_XML_DICTIONARY dictionary;
    WS_XML_STRING quantity;
    WS_XML_STRING productName;
    WS_XML_STRING purchaseOrder;
    WS_XML_STRING purchaseOrderNamespace;
};

static PurchaseOrderDictionary purchaseOrderDictionary =
{
    { 
        { /* A unique GUID generated from uuidgen */ },
        &purchaseOrderDictionary.quantity,
        4, 
        TRUE 
    },
    WS_XML_STRING_DICTIONARY_VALUE("Quantity",           &purchaseOrderDictionary.dictionary, 0),
    WS_XML_STRING_DICTIONARY_VALUE("ProductName",        &purchaseOrderDictionary.dictionary, 1),
    WS_XML_STRING_DICTIONARY_VALUE("PurchaseOrder",      &purchaseOrderDictionary.dictionary, 2),
    WS_XML_STRING_DICTIONARY_VALUE("http://example.com", &purchaseOrderDictionary.dictionary, 3),
};

Zeichenfolgen aus dem Wörterbuch können wie folgt verwendet werden:

WsWriteStartElement(xmlWriter, NULL, &purchaseOrderDictionary.purchaseOrder, &purchaseOrderDictionary.purchaseOrderNamespace, error);

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile webservices.h