Поделиться через

структура 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);

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть webservices.h