Поделиться через

структура WS_XML_STRING (webservices.h)

  • Статья

Представляет строку, с ней при необходимости связаны сведения о словаре . API xml используют WS_XML_STRINGs для идентификации префиксов, локальных имен и пространств имен.

Синтаксис

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

Члены

length

Число байтов в представлении строки в кодировке UTF-8.

bytes

Строка, закодированная как UTF-8 байт.

dictionary

Указатель на словарь, содержащий строку. Если строка не является частью словаря, то значением может быть NULL.

id

Значение , однозначно определяющее строку в указанном словаре. Запись в dictionary-strings>[id] должна идентифицировать эту строку.

Если словарь имеет значение NULL, то это значение не используется.

Комментарии

Строка представлена в виде байтов в кодировке UTF-8, а не WCHAR. Он не обязательно должен завершаться нулевым значением.

Для инициализации этой структуры можно использовать макросы WS_XML_STRING_VALUE, WS_XML_STRING_NULL и WS_XML_STRING_DICTIONARY_VALUE .

Сведения о словаре используются двоичной кодировкой для написания более компактного xml-документа.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Верхняя часть webservices.h