structure WS_XML_STRING (webservices.h)

Représente une chaîne à laquelle des informations de dictionnaire sont éventuellement associées. Les API xml utilisent WS_XML_STRINGs pour identifier les préfixes, les noms locaux et les espaces de noms.

Syntaxe

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

Membres

length

Nombre d’octets dans la représentation encodée UTF-8 de la chaîne.

bytes

Chaîne encodée en UTF-8 octets.

dictionary

Pointeur vers le dictionnaire qui contient la chaîne. Si la chaîne ne fait pas partie d’un dictionnaire, la valeur peut être NULL.

id

Valeur qui identifie de manière unique la chaîne dans le dictionnaire spécifié. L’entrée dans dictionary-strings>[id] doit identifier cette chaîne.

Si le dictionnaire a la valeur NULL, cette valeur n’est pas utilisée.

Remarques

La chaîne est représentée sous forme d’octets encodés en UTF-8, et non de WCHAR. Il n’est pas obligatoire d’être terminé à zéro.

Les macros WS_XML_STRING_VALUE, WS_XML_STRING_NULL et WS_XML_STRING_DICTIONARY_VALUE peuvent être utilisées pour initialiser cette structure.

Les informations du dictionnaire sont utilisées par l’encodage binaire pour écrire un document xml plus compact.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau | Applications UWP]
En-tête	webservices.h