Condividi tramite

struttura WS_FIELD_DESCRIPTION (webservices.h)

  • Articolo

Rappresenta le informazioni di serializzazione su un campo all'interno di una struttura.

Sintassi

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;

Members

mapping

Identifica il mapping del campo al codice XML. Vedere WS_FIELD_MAPPING per i modi in cui il campo può essere esposto nel contenuto XML.

localName

Nome locale XML da utilizzare per il campo.

Questo campo è obbligatorio, tranne nel caso seguente, in cui può essere NULL. Se il campo di mapping è WS_REPEATING_ELEMENT_FIELD_MAPPING, questo identifica il nome locale dell'elemento "wrapper" che è l'elemento padre degli elementi dell'elemento della matrice. L'impostazione di questo campo (e del campo ns) su NULL ometterà l'elemento wrapper. I campi ns e localName devono essere entrambi specificati o null.

ns

Spazio dei nomi XML da utilizzare per il campo.

Questo campo è obbligatorio, tranne nel caso seguente, in cui può essere NULL. Se il campo di mapping è WS_REPEATING_ELEMENT_FIELD_MAPPING, questo identifica lo spazio dei nomi dell'elemento "wrapper" che è l'elemento padre degli elementi dell'elemento della matrice. L'impostazione di questo campo (e il campo localName) su NULL ometterà l'elemento wrapper. I campi ns e localName devono essere entrambi specificati o null.

type

Tipo del campo. Per un elenco dei tipi supportati, vedere WS_TYPE .

typeDescription

Informazioni aggiuntive sul tipo. Ogni tipo ha una struttura di descrizione diversa. Può trattarsi di NULL, a seconda del WS_TYPE.

offset

Offset del campo all'interno della struttura contenitore.

options

Flag aggiuntivi per il campo. Per un elenco di flag, vedere WS_FIELD_OPTIONS . Se non sono necessari flag, potrebbe essere 0.

defaultValue

Punta a un valore predefinito per il campo. Viene usato nelle istanze seguenti:

Se defaultValue è NULL, equivale a avere un valore predefinito di tutti gli zero.

countOffset

Offset della struttura del campo ULONG che rappresenta il numero di elementi nella matrice.

Questo campo viene usato quando si usano WS_REPEATING_ELEMENT_FIELD_MAPPING o tipi di matrice (WS_CHAR_ARRAY_TYPE, WS_UTF8_ARRAY_TYPE, WS_BYTE_ARRAY_TYPE).
In altri casi, non è necessario specificare (può essere 0).

itemLocalName

Nome locale XML da utilizzare per gli elementi ripetuti quando si utilizza WS_REPEATING_ELEMENT_FIELD_MAPPING.

In altri casi questo campo non deve essere specificato (può essere NULL).

itemNs

Spazio dei nomi XML da utilizzare per gli elementi ripetuti quando si utilizza WS_REPEATING_ELEMENT_FIELD_MAPPING.

In altri casi questo campo non deve essere specificato (può essere NULL).

itemRange

Numero minimo e massimo di elementi ripetuti che possono essere visualizzati quando si usano WS_REPEATING_ELEMENT_FIELD_MAPPING, WS_REPEATING_ELEMENT_CHOICE_FIELD_MAPPING o WS_REPEATING_ANY_ELEMENT_FIELD_MAPPING. Se non specificato (NULL), il valore minimo è 0 e il valore massimo è MAX ULONG.

In altri casi questo campo non deve essere specificato (può essere NULL).

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Intestazione webservices.h