次の方法で共有

WsReadCharsUtf8 関数 (webservices.h)

  • [アーティクル]

リーダーから指定した数のテキスト文字を読み取り、UTF-8 でエンコードして返します。

構文

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

パラメーター

[in] reader

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

bytes

読み取られたエンコードされたバイトを配置するバッファーへのポインター。

[in] maxByteCount

読み取る必要がある最大バイト数。

[out] actualByteCount

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

[in, optional] error

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

戻り値

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

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

注釈

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

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

要件

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