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

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

  • Статья

Представляет сведения о сериализации поля в структуре.

Синтаксис

typedef struct _WS_FIELD_DESCRIPTION {
  WS_FIELD_MAPPING mapping;
  WS_XML_STRING    *localName;
  WS_XML_STRING    *ns;
  WS_TYPE          type;
  void             *typeDescription;
  ULONG            offset;
  ULONG            options;
  WS_DEFAULT_VALUE *defaultValue;
  ULONG            countOffset;
  WS_XML_STRING    *itemLocalName;
  WS_XML_STRING    *itemNs;
  WS_ITEM_RANGE    *itemRange;
} WS_FIELD_DESCRIPTION;

Члены

mapping

Определяет, как поле сопоставляется с XML. Способы предоставления поля в XML-содержимом см. в WS_FIELD_MAPPING .

localName

Локальное имя XML, используемое для поля.

Это поле является обязательным, за исключением следующего случая, когда оно может иметь значение NULL. Если поле сопоставления WS_REPEATING_ELEMENT_FIELD_MAPPING, оно определяет локальное имя элемента-оболочки, который является родительским элементом элементов массива. Если задать для этого поля (и поля ns) значение NULL , элемент-оболочку будет пропущен. Поля ns и localName должны быть либо указаны, либо оба значения NULL.

ns

Пространство имен XML, используемое для поля.

Это поле является обязательным, за исключением следующего случая, когда оно может иметь значение NULL. Если поле сопоставления WS_REPEATING_ELEMENT_FIELD_MAPPING, оно определяет пространство имен элемента-оболочки, который является родительским элементом элементов массива. Если для этого поля (и поля localName) задано значение NULL , элемент-оболочка будет пропущен. Поля ns и localName должны быть либо указаны, либо оба значения NULL.

type

Тип поля. Список поддерживаемых типов см. в WS_TYPE .

typeDescription

Дополнительные сведения о типе. Каждый тип имеет разную структуру описания. В зависимости от WS_TYPE это значение может иметь значение NULL.

offset

Смещение поля в содержащей структуре.

options

Дополнительные флаги для поля. Список флагов см. в WS_FIELD_OPTIONS . Если флаги не требуются, это может быть 0.

defaultValue

Указывает на значение по умолчанию для поля. Используется в следующих экземплярах:

Если defaultValue имеет значение NULL, это то же самое, что и значение по умолчанию всех нулей.

countOffset

Смещение структуры поля ULONG, представляющего количество элементов в массиве.

Это поле используется при использовании типов WS_REPEATING_ELEMENT_FIELD_MAPPING или массивов (WS_CHAR_ARRAY_TYPE, WS_UTF8_ARRAY_TYPEWS_BYTE_ARRAY_TYPE).
В других случаях его не нужно указывать (может быть 0).

itemLocalName

Локальное имя XML, используемое для повторяющихся элементов при использовании WS_REPEATING_ELEMENT_FIELD_MAPPING.

В других случаях это поле указывать не нужно (оно может иметь значение NULL).

itemNs

Пространство имен XML, используемое для повторяющихся элементов при использовании WS_REPEATING_ELEMENT_FIELD_MAPPING.

В других случаях это поле указывать не нужно (оно может иметь значение NULL).

itemRange

Минимальное и максимальное количество повторяющихся элементов, которые могут отображаться при использовании WS_REPEATING_ELEMENT_FIELD_MAPPING, WS_REPEATING_ELEMENT_CHOICE_FIELD_MAPPING или WS_REPEATING_ANY_ELEMENT_FIELD_MAPPING. Если значение не указано (NULL), минимальное значение равно 0, а максимальное значение — MAX ULONG.

В других случаях это поле указывать не нужно (оно может иметь значение NULL).

Требования

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