estrutura WS_XML_DICTIONARY (webservices.h)

Representa um conjunto de cadeias de caracteres exclusivas. Essas informações são usadas pela codificação binária para gravar um documento xml mais compacto.

Sintaxe

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

Membros

guid

Um guid que identifica exclusivamente o conjunto de cadeias de caracteres representado pelo dicionário. O guid nunca é transmitido ou persistido e só precisa ser exclusivo durante o tempo de vida do processo.

strings

O conjunto de cadeias de caracteres exclusivas que compõem o dicionário.

stringCount

Especifica o número de cadeias de caracteres no dicionário.

isConst

Indica se o dicionário e seu conteúdo são declarados const e se eles serão mantidos válidos durante todo o tempo de vida de qualquer objeto com o qual as cadeias de caracteres no dicionário são usadas.

Se isso for TRUE, as cadeias de caracteres poderão ser manipuladas com mais eficiência.

Comentários

Todas as cadeias de caracteres e valores dentro de um dicionário devem ser exclusivos. Os dicionários são sempre considerados bem formados, portanto, cabe ao criador do dicionário garantir que esse seja o caso.

Um dicionário pode ser declarado como:

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

Cadeias de caracteres do dicionário podem ser usadas como:

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

Requisitos