次の方法で共有


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の場合、配列項目要素の親要素である "wrapper" 要素のローカル名が識別されます。 このフィールド (および 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

WS_REPEATING_ELEMENT_FIELD_MAPPINGを使用するときに繰り返し要素に使用する XML ローカル名。

それ以外の場合は、このフィールドを指定する必要はありません ( NULL にすることができます)。

itemNs

WS_REPEATING_ELEMENT_FIELD_MAPPINGを使用するときに繰り返し要素に使用する XML 名前空間。

それ以外の場合は、このフィールドを指定する必要はありません ( 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 [デスクトップ アプリのみ]
Header webservices.h