WsWriteEndStartElement 関数 (webservices.h)
ライターが現在の要素をコミットし、それ以上の属性が要素に書き込まれないように強制します。
構文
HRESULT WsWriteEndStartElement(
[in] WS_XML_WRITER *writer,
[in, optional] WS_ERROR *error
);
パラメーター
[in] writer
現在の要素をコミットするライター。
[in, optional] error
関数が失敗した場合に追加のエラー情報を格納する場所を指定します。
戻り値
この関数は、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
1 つ以上の引数が無効です。 |
|
オブジェクトの現在の状態のため、操作は許可されません。 |
|
入力データの形式が正しくないか、予期した値が指定されていませんでした。 |
|
クォータを超えました。 |
解説
場合によっては、要素の完了を明示的に強制すると便利です。 これは、ライターに完全な要素とペアを強制的に書き込む場合に使用できます。 また、 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 |