WS_XML_DICTIONARY結構 (webservices.h)

表示一組唯一字串。 二進位編碼會使用此資訊來撰寫更精簡的 xml 檔。

語法

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

成員

guid

GUID，可唯一識別字典所代表的字串集。 guid 永遠不會傳輸或保存，而且在進程的存留期內只需要是唯一的。

strings

組成字典的唯一字串集合。

stringCount

指定字典中的字串數目。

isConst

指出字典及其內容是否宣告為 const，而且它們將在使用字典中字元串的任何對象整個存留期內保持有效。

如果這是 TRUE，則可以更有效率地操作字串。

備註

字典中的所有字串和值都必須是唯一的。 字典一律假設為格式正確，因此字典的建立者必須確定這是這種情況。

字典可能宣告為：

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),
};

字典中的字串可能用來做為：

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

規格需求