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

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Cabeçalho	webservices.h