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
フィールドの既定値をポイントします。 これは、次のインスタンスで使用されます。
- WS_FIELD_OPTIONAL が指定され、XML に値が含まれていませんでした。
- WS_NO_FIELD_MAPPING が指定されました。
countOffset
配列内の項目数を表す ULONG フィールドの構造体オフセット。
このフィールドは、WS_REPEATING_ELEMENT_FIELD_MAPPING型または配列型 (WS_CHAR_ARRAY_TYPE、WS_UTF8_ARRAY_TYPE、WS_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 |