Share via


estructura WS_XML_STRING (webservices.h)

Representa una cadena que opcionalmente tiene información de diccionario asociada. Las API xml usan WS_XML_STRINGs para identificar prefijos, nombres locales y espacios de nombres.

Sintaxis

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

Miembros

length

Número de bytes de la representación codificada UTF-8 de la cadena.

bytes

Cadena codificada como bytes UTF-8.

dictionary

Puntero al diccionario que contiene la cadena. Si la cadena no forma parte de un diccionario, el valor puede ser NULL.

id

Valor que identifica de forma única la cadena dentro del diccionario especificado. La entrada de dictionary-strings>[id] debe identificar esta cadena.

Si el diccionario es NULL, este valor no se usa.

Comentarios

La cadena se representa como bytes codificados UTF-8, no como WCHAR. No es necesario que termine cero.

Las macros WS_XML_STRING_VALUE, WS_XML_STRING_NULL y WS_XML_STRING_DICTIONARY_VALUE se pueden usar para inicializar esta estructura.

La codificación binaria usa la información del diccionario para escribir un documento xml más compacto.

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