次の方法で共有


WsWriteEndStartElement 関数 (webservices.h)

ライターが現在の要素をコミットし、それ以上の属性が要素に書き込まれないように強制します。

構文

HRESULT WsWriteEndStartElement(
  [in]           WS_XML_WRITER *writer,
  [in, optional] WS_ERROR      *error
);

パラメーター

[in] writer

現在の要素をコミットするライター。

[in, optional] error

関数が失敗した場合に追加のエラー情報を格納する場所を指定します。

戻り値

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

リターン コード 説明
E_INVALIDARG
1 つ以上の引数が無効です。
WS_E_INVALID_OPERATION
オブジェクトの現在の状態のため、操作は許可されません。
WS_E_INVALID_FORMAT
入力データの形式が正しくないか、予期した値が指定されていませんでした。
WS_E_QUOTA_EXCEEDED
クォータを超えました。

解説

場合によっては、要素の完了を明示的に強制すると便利です。 これは、ライターに完全な要素とペアを強制的に書き込む場合に使用できます。 また、 WS_XML_BUFFERに書き込むときに位置を取得する場合にも役立ちます。

コミットする要素がない場合にこの API を呼び出すと、 WS_E_INVALID_OPERATIONが返されます。 ( 「Windows Web Services の戻り値」を参照してください)。

要件

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