WS_FIELD_DESCRIPTION-Struktur (webservices.h)

Represents serialization information about a field within a structure.

Syntax

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;

Member

mapping

Gibt an, wie das Feld dem XML-Code zugeordnet wird. Unter WS_FIELD_MAPPING erfahren Sie, wie das Feld im XML-Inhalt verfügbar gemacht werden kann.

localName

Der lokale XML-Name, der für das Feld verwendet werden soll.

Dieses Feld ist erforderlich, außer im folgenden Fall, in dem es NULL sein kann. Wenn das Zuordnungsfeld WS_REPEATING_ELEMENT_FIELD_MAPPING ist, identifiziert dies den lokalen Namen des Wrapperelements, das das übergeordnete Element der Arrayelementelemente ist. Wenn Sie dieses Feld (und das Feld ns) auf NULL festlegen, wird das Wrapperelement weggelassen. Die Felder ns und localName müssen entweder beide angegeben oder NULL sein.

ns

Der XML-Namespace, der für das Feld verwendet werden soll.

Dieses Feld ist erforderlich, außer im folgenden Fall, in dem es NULL sein kann. Wenn das Zuordnungsfeld WS_REPEATING_ELEMENT_FIELD_MAPPING ist, identifiziert dies den Namespace des "Wrapper"-Elements, das das übergeordnete Element der Arrayelementelemente ist. Wenn Sie dieses Feld (und das Feld localName) auf NULL festlegen, wird das Wrapperelement weggelassen. Die Felder ns und localName müssen entweder beide angegeben oder NULL sein.

type

Der Typ des Felds. Eine Liste der unterstützten Typen finden Sie unter WS_TYPE .

typeDescription

Zusätzliche Informationen zum Typ. Jeder Typ verfügt über eine andere Beschreibungsstruktur. Dies kann je nach WS_TYPENULL sein.

offset

Der Offset des Felds innerhalb der enthaltenden Struktur.

options

Zusätzliche Flags für das Feld. Eine Liste der Flags finden Sie unter WS_FIELD_OPTIONS . Wenn keine Flags erforderlich sind, kann dies 0 sein.

defaultValue

Zeigt auf einen Standardwert für das Feld. Dies wird in den folgenden Instanzen verwendet:

• WS_FIELD_OPTIONAL wurde angegeben, und der XML-Code enthielt den Wert nicht.
• WS_NO_FIELD_MAPPING wurde angegeben.

countOffset

Der Strukturoffset des ULONG-Felds, das die Anzahl der Elemente im Array darstellt.

Dieses Feld wird verwendet, wenn WS_REPEATING_ELEMENT_FIELD_MAPPING - oder Arraytypen (WS_CHAR_ARRAY_TYPE, WS_UTF8_ARRAY_TYPE, WS_BYTE_ARRAY_TYPE) verwendet werden.
In anderen Fällen muss er nicht angegeben werden (es kann 0 sein).

itemLocalName

Der lokale XML-Name, der für die wiederholten Elemente verwendet werden soll, wenn WS_REPEATING_ELEMENT_FIELD_MAPPING verwendet wird.

In anderen Fällen muss dieses Feld nicht angegeben werden (es kann NULL sein).

itemNs

Der XML-Namespace, der für die wiederholten Elemente verwendet werden soll, wenn WS_REPEATING_ELEMENT_FIELD_MAPPING verwendet wird.

In anderen Fällen muss dieses Feld nicht angegeben werden (es kann NULL sein).

itemRange

Die minimale und maximale Anzahl von wiederholten Elementen, die bei verwendung von WS_REPEATING_ELEMENT_FIELD_MAPPING, WS_REPEATING_ELEMENT_CHOICE_FIELD_MAPPING oder WS_REPEATING_ANY_ELEMENT_FIELD_MAPPING angezeigt werden können. Wenn nicht angegeben (NULL), ist das Minimum 0, und das Maximum ist MAX ULONG.

In anderen Fällen muss dieses Feld nicht angegeben werden (es kann NULL sein).

Anforderungen