estrutura WS_XML_STRING (webservices.h)

Representa uma cadeia de caracteres que, opcionalmente, tem informações de dicionário associadas a ela. As APIs xml usam WS_XML_STRINGs para identificar prefixos, localNames e namespaces.

Sintaxe

typedef struct _WS_XML_STRING {
  ULONG             length;
  BYTE              *bytes;
  WS_XML_DICTIONARY *dictionary;
  ULONG             id;
} WS_XML_STRING;

Membros

length

O número de bytes na representação codificada em UTF-8 da cadeia de caracteres.

bytes

A cadeia de caracteres codificada como bytes UTF-8.

dictionary

Um ponteiro para o dicionário que contém a cadeia de caracteres. Se a cadeia de caracteres não fizer parte de um dicionário, o valor poderá ser NULL.

id

Um valor que identifica exclusivamente a cadeia de caracteres dentro do dicionário especificado. A entrada em dictionary-strings>[id] deve identificar essa cadeia de caracteres.

Se o dicionário for NULL, esse valor não será utilizado.

Comentários

A cadeia de caracteres é representada como bytes codificados em UTF-8, não WCHARs. Não é necessário ter zero terminado.

As macros WS_XML_STRING_VALUE, WS_XML_STRING_NULL e WS_XML_STRING_DICTIONARY_VALUE podem ser usadas para inicializar essa estrutura.

As informações do dicionário são usadas pela codificação binária para escrever um documento xml mais compacto.

Requisitos