WsReadBytes 関数 (webservices.h)

Reader からテキストを読み取り、base64 仕様に従って文字をバイトとしてデコードします。

構文

HRESULT WsReadBytes(
  [in]           WS_XML_READER *reader,
                 void          *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 より小さい場合があります。

[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