Share via

WsReadNode 関数 (webservices.h)

  • [アーティクル]

この操作により、リーダーが入力ストリーム内の次の ノード に進みます。 入力の解析中にエラーが発生した場合、関数は WS_E_INVALID_FORMATを返します。 ( 「Windows Web Services の戻り値」を参照してください)。

構文

HRESULT WsReadNode(
  [in]           WS_XML_READER *reader,
  [in, optional] WS_ERROR      *error
);

パラメーター

[in] reader

進める XML Reader オブジェクトへのポインター。 ポインターは有効な WS_XML_READER を参照する必要があり、 NULL ではない可能性があります。

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_E_INVALID_FORMAT
 入力データが予期した形式でなかったか、予期した値を持っていないか、複数の最上位要素が見つか り、WS_XML_READER_PROPERTY_ALLOW_FRAGMENT が FALSE です。
WS_E_QUOTA_EXCEEDED
 WS_XML_READER_PROPERTY_MAX_DEPTHやWS_XML_READER_PROPERTY_MAX_ATTRIBUTESなどの制限を超えた要素が読み取られました。

注釈

その他の例外条件は次のとおりです。

  • XML 宣言が見つかり、 WS_XML_READER_PROPERTY_READ_DECLARATION が FALSE の場合は、 WS_E_INVALID_FORMAT が返されます。
  • リーダーが WS_XML_READER_STREAM_INPUT を使用していて、バッファーに格納されたデータが不足していた場合、リーダーは WS_E_QUOTA_EXCEEDEDを返します。

要件

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