Freigeben über

WS_FIELD_DESCRIPTION-Struktur (webservices.h)

  • Artikel

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:

Wenn defaultValue NULL ist, entspricht dies dem Standardwert aller Nullen.

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

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile webservices.h