WsFillReader 関数 (webservices.h)

リーダーが、後続のリーダー関数で使用するために XML データの最小バイト数をバッファーに格納していることを確認します。 minSize パラメーターの値で指定されたバイト数を取得するために、WS_XML_READER_STREAM_INPUTで指定されたコールバックが必要な回数だけ呼び出されます。 完了すると、バッファーに格納されたデータは他のリーダー関数で使用できます。 後続のリーダー関数で取得されたデータよりも多くのデータが必要な場合、関数は WS_E_QUOTA_EXCEEDED 例外を返します。 ( 「Windows Web サービスの戻り値」を参照してください)。

構文

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

パラメーター

[in] reader

データの取得に使用 されるWS_XML_READER 構造体へのポインター。

[in] minSize

リーダーが取得する必要がある最小バイト数を指定します。 バッファーに格納されている現在のバイト数が minSize の値以上の場合、関数は何も行わないので、すぐに返されます。

[in, optional] asyncContext

関数の非同期呼び出しに関する情報を含む WS_ASYNC_CONTEXT データ構造へのポインター。 NULL 値は、同期操作の要求を示します。

[in, optional] error

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

戻り値

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

注釈

XML データの特定のセグメントを読み取るために必要なバイト数は、エンコードとその書式設定によって異なります。

この関数は、WS_XML_READER_BUFFER_INPUTを使用してリーダーと共に使用する場合、"no-op" です。

WS_ASYNC_CONTEXTを指定すると、データは非同期的に読み取られます。

要件