次の方法で共有

WsWriteValue 関数 (webservices.h)

  • [アーティクル]

この操作は、基になるエンコーディングからプリミティブ値の最適な表現を派生させ、その派生値を Writer オブジェクトに渡します。

メモ 通常、この関数を使用してプリミティブ値を書き出す方が、値をテキストに変換してから WsWriteChars を使用するよりも効率的です。

 

構文

HRESULT WsWriteValue(
  [in]           WS_XML_WRITER *writer,
  [in]           WS_VALUE_TYPE valueType,
                 const void    *value,
  [in]           ULONG         valueSize,
  [in, optional] WS_ERROR      *error
);

パラメーター

[in] writer

値が書き込まれる WS_XML_WRITER オブジェクトへのポインター。 ポインターは、有効な XML ライター オブジェクトを参照する必要があります。

[in] valueType

value パラメーターによって参照されるプリミティブ値の型を示します。

I

value

プリミティブ値への void ポインター。

[in] valueSize

書き込まれる値のサイズ (バイト単位)。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。
WS_E_INVALID_OPERATION
 オブジェクトの現在の状態のため、操作は許可されません。

解説

WsWriteValue は、 WsWriteStartAttribute と WsWriteEndAttribute の間で 1 回だけ呼び出されます。 属性を記述するときに、 WsWriteChars、 WsWriteBytes、 WsWriteCharsUtf8 、 または WsWriteText と組み合わせられない場合があります。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー webservices.h
Library WebServices.lib
[DLL] WebServices.dll