WsWriteType 関数 (webservices.h)
指定したWS_TYPEの値を 、WS_TYPE_MAPPING に従って XML に書き込 みます。
構文
HRESULT WsWriteType(
[in] WS_XML_WRITER *writer,
[in] WS_TYPE_MAPPING typeMapping,
[in] WS_TYPE type,
[in, optional] const void *typeDescription,
[in] WS_WRITE_OPTION writeOption,
const void *value,
[in] ULONG valueSize,
[in, optional] WS_ERROR *error
);
パラメーター
[in] writer
値を書き込むライター。
[in] typeMapping
型が書き込まれる XML にどのようにマップされるかについて説明します。
[in] type
シリアル化する値の型。
[in, optional] typeDescription
型に関する追加情報。 各型には、異なる説明構造があります。 これは、WS_TYPEによっては NULL になる場合があります。
[in] writeOption
値が必要かどうか、および値の割り当て方法。 詳細については、「 WS_WRITE_OPTION 」を参照してください。
このパラメーターには、次のいずれかの値が必要です。
value
シリアル化する値へのポインター。
[in] valueSize
シリアル化される値のサイズ。
[in, optional] error
関数が失敗した場合に追加のエラー情報を格納する場所を指定します。
戻り値
この関数は、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
入力データの形式が正しくないか、予期した値が指定されていませんでした。 |
|
1 つ以上の引数が無効です。 |
|
メモリ不足。 |
|
この関数は、上記以外のエラーを返す場合があります。 |
注釈
この関数を使用して要素と属性の値を書き込む方法については、「 WS_TYPE_MAPPING 」を参照してください。
API が失敗した場合、入力ライターの状態は未定義になります。 この場合にライターで使用できる API は、ライターを使用可能な状態に戻す 場合は WsSetOutput と WsSetOutputToBuffer のみ、ライターを解放するには WsFreeWriter だけです。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | webservices.h |
Library | WebServices.lib |
[DLL] | WebServices.dll |