Compartir a través de

estructura WS_XML_DICTIONARY (webservices.h)

  • Artículo

Representa un conjunto de cadenas únicas. Esta información la usa la codificación binaria para escribir un documento xml más compacto.

Sintaxis

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

Miembros

guid

Guid que identifica de forma única el conjunto de cadenas representadas por el diccionario. El guid nunca se transmite o conserva, y solo debe ser único durante la vigencia del proceso.

strings

Conjunto de cadenas únicas que componen el diccionario.

stringCount

Especifica el número de cadenas del diccionario.

isConst

Indica si el diccionario y su contenido se declaran const y que se mantendrán válidos durante toda la duración de cualquier objeto con el que se usen las cadenas del diccionario.

Si es TRUE, las cadenas se pueden manipular de forma más eficaz.

Comentarios

Todas las cadenas y valores de un diccionario deben ser únicas. Siempre se supone que los diccionarios tienen un formato correcto, por lo que es el creador del diccionario para asegurarse de que este es el caso.

Un diccionario se puede declarar 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),
};

Las cadenas del diccionario se pueden usar como:

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Encabezado webservices.h