通过

webservices.h) (WS_XML_DICTIONARY 结构

  • 项目

表示一组唯一字符串。 二进制编码使用此信息来编写更紧凑的 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);

要求

要求 值
最低受支持的客户端 Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头 webservices.h