WS_XML_DICTIONARY struttura (webservices.h)

Articolo
03/13/2024

Rappresenta un set di stringhe univoche. Queste informazioni vengono usate dalla codifica binaria per scrivere un documento xml più compatto.

Sintassi

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

Members

guid

Guid che identifica in modo univoco il set di stringhe rappresentate dal dizionario. Il guid non viene mai trasmesso o persistente e deve essere univoco solo per la durata del processo.

strings

Set di stringhe univoche che comprendono il dizionario.

stringCount

Specifica il numero di stringhe nel dizionario.

isConst

Indica se il dizionario e il relativo contenuto vengono dichiarati const e che verranno mantenuti validi per l'intera durata di qualsiasi oggetto con cui vengono usate le stringhe del dizionario.

Se si tratta di TRUE, le stringhe possono essere modificate in modo più efficiente.

Commenti

Tutte le stringhe e i valori all'interno di un dizionario devono essere univoci. I dizionari vengono sempre considerati ben formati, quindi è il creatore del dizionario per assicurarsi che questo sia il caso.

Un dizionario potrebbe essere dichiarato come:

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 */ },
        &amp;purchaseOrderDictionary.quantity,
        4, 
        TRUE 
    },
    WS_XML_STRING_DICTIONARY_VALUE("Quantity",           &amp;purchaseOrderDictionary.dictionary, 0),
    WS_XML_STRING_DICTIONARY_VALUE("ProductName",        &amp;purchaseOrderDictionary.dictionary, 1),
    WS_XML_STRING_DICTIONARY_VALUE("PurchaseOrder",      &amp;purchaseOrderDictionary.dictionary, 2),
    WS_XML_STRING_DICTIONARY_VALUE("http://example.com", &amp;purchaseOrderDictionary.dictionary, 3),
};

Le stringhe del dizionario possono essere usate come:

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Intestazione	webservices.h

Condividi tramite