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

перечисление WS_ENCODING (webservices.h)

  • Статья

Различные кодировки (форматы сообщений).

Синтаксис

typedef enum {
  WS_ENCODING_XML_BINARY_1 = 0,
  WS_ENCODING_XML_BINARY_SESSION_1 = 1,
  WS_ENCODING_XML_MTOM_UTF8 = 2,
  WS_ENCODING_XML_MTOM_UTF16BE = 3,
  WS_ENCODING_XML_MTOM_UTF16LE = 4,
  WS_ENCODING_XML_UTF8 = 5,
  WS_ENCODING_XML_UTF16BE = 6,
  WS_ENCODING_XML_UTF16LE = 7,
  WS_ENCODING_RAW = 8
} WS_ENCODING;

Константы

 
WS_ENCODING_XML_BINARY_1
Значение: 0
Двоичная кодировка XML.


Хотя данные по-прежнему в XML
формат infoset, эта кодировка обычно приводит к меньшему размеру сообщений
для производства и потребления ресурсов требуется меньше ресурсов ЦП.


Для этой кодировки требуется ПРОТОКОЛ SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_BINARY_SESSION_1
Значение: 1
Двоичная кодировка сеанса XML.


Хотя данные по-прежнему в XML
формат infoset, эта кодировка обычно приводит к меньшему размеру сообщений
для производства и потребления ресурсов требуется меньше ресурсов ЦП.


Эта кодировка похожа на WS_ENCODING_XML_BINARY_1 но добавляет
компонент словаря сеансов. Так как для этой кодировки требуется
сеанс, его можно использовать только в типах каналов с сеансами
(WS_CHANNEL_TYPE_DUPLEX_SESSION).


Словарь сеансов — это структура данных, поддерживаемая обоими
сторона отправки и получения канала. Словарь сеансов
используется для оптимизации передачи строковых данных. Первый раз
записывается определенная строка, она кодируется с помощью в полной строке
ЧЧ:ММ:СС... Если та же строка записывается снова, она будет использовать меньший
форма с маркерами, которая может уменьшить размер сообщения.


Модуль записи строковых данных выбирает, какие строки являются кандидатами на
словарь сеанса путем заполнения полей словаря и идентификатора
структура WS_XML_STRING .


Размер словаря сеанса настраивается с помощью
WS_CHANNEL_PROPERTY_MAX_SESSION_DICTIONARY_SIZE.


Для этой кодировки требуется ПРОТОКОЛ SOAP 1.2 (WS_ENVELOPE_VERSION_SOAP_1_2).
WS_ENCODING_XML_MTOM_UTF8
Значение: 2
Кодировка MTOM.


Кодирование MTOM оптимизирует двоичные данные, избегая затрат
преобразования двоичных данных в формат base64. Для сообщений, содержащих
большие объемы двоичных данных, такое кодирование обычно приводит к меньшему размеру
сообщения, для которых требуется меньше ресурсов ЦП для производства и использования
чем с кодировкой текста. Эта кодировка обычно не так эффективна, как
Двоичная кодировка, однако.


Записывается XML-часть пакета MTOM.
с помощью WS_CHARSET_UTF8, но при чтении может находиться в любом WS_CHARSET .
WS_ENCODING_XML_MTOM_UTF16BE
Значение: 3
Кодировка MTOM.


Кодирование MTOM оптимизирует двоичные данные, избегая затрат
преобразования двоичных данных в формат base64. Для сообщений, содержащих
большие объемы двоичных данных, такое кодирование обычно приводит к меньшему размеру
сообщения, для которых требуется меньше ресурсов ЦП для производства и использования
чем с кодировкой текста. Эта кодировка обычно не так эффективна, как
Двоичная кодировка, однако.


Записывается XML-часть пакета MTOM.
с помощью WS_CHARSET_UTF16BE, но может находиться в любом WS_CHARSET при чтении.
WS_ENCODING_XML_MTOM_UTF16LE
Значение: 4
Кодировка MTOM.


Кодирование MTOM оптимизирует двоичные данные, избегая затрат
преобразования двоичных данных в формат base64. Для сообщений, содержащих
большие объемы двоичных данных, такое кодирование обычно приводит к меньшему размеру
сообщения, для которых требуется меньше ресурсов ЦП для производства и использования
чем с кодировкой текста. Эта кодировка обычно не так эффективна, как
Двоичная кодировка, однако.


Записывается XML-часть пакета MTOM.
с помощью WS_CHARSET_UTF16LE, но может находиться в любом WS_CHARSET при чтении.
WS_ENCODING_XML_UTF8
Значение: 5
Кодировка текста (формат XML 1.0).


Данные записываются с помощью WS_CHARSET_UTF8,
но может находиться в любом WS_CHARSET при чтении.
WS_ENCODING_XML_UTF16BE
Значение: 6
Кодировка текста (формат XML 1.0).


Данные записываются с помощью WS_CHARSET_UTF16BE,
но может находиться в любом WS_CHARSET при чтении.
WS_ENCODING_XML_UTF16LE
Значение: 7
Кодировка текста (формат XML 1.0).


Данные записываются с помощью WS_CHARSET_UTF16LE,
но может находиться в любом WS_CHARSET при чтении.
WS_ENCODING_RAW
Значение: 8

Требования

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