WsReadChars 関数 (webservices.h)

リーダーから指定した数のテキスト文字を読み取ります。

構文

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [in, optional] WS_ERROR      *error
);

パラメーター

[in] reader

文字データの読み取り元となる XML リーダー へのポインター。 ポインターは、有効な WS_XML_READER オブジェクトを参照する必要があります。

chars

読み取られた文字の場所へのポインター。

[in] maxCharCount

読み取る必要がある最大文字数。

[out] actualCharCount

読み取られた実際の文字数の ULONG 値へのポインター。 残りの文字数が多い場合でも、maxCharCount より小さい場合があります。 0 を返す場合は、これ以上の文字はありません。

[in, optional] error

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

戻り値

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

リターン コード	説明
WS_E_INVALID_FORMAT	入力データの形式が正しくないか、予期した値が指定されていませんでした。
WS_E_QUOTA_EXCEEDED	クォータを超えました。

注釈

テキストは、開始要素または終了要素まで読み取られます。 コメントはスキップされ、CDATA コンテンツは要素コンテンツと同じように扱われます。 文字エンティティは、エスケープされていない形式に変換されます。

この関数は、 WsReadNode に記載されている任意の理由で失敗する可能性があります。

要件

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