WsFillReader 函式 (webservices.h)

  • 發行項

確保讀取器已緩衝處理 XML 數據的最小位元組計數，以供後續讀取器函式使用。 它會叫用 WS_XML_READER_STREAM_INPUT 指定的回呼次數，以取得 minSize 參數值所指定的位元元組數目。 完成時，緩衝數據可供其他讀取器函式使用。 如果後續讀取器函式需要的數據超過取得的數據，函式會傳回 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 物件的指標，如果函式失敗，應該儲存錯誤的其他資訊。

傳回值

此函式可以傳回其中一個值。

傳回碼 Description
WS_S_ASYNC
 異步操作仍然擱置中。

備註

讀取特定 XML 數據區段所需的位元元組數目取決於編碼及其格式。

使用 WS_XML_READER_BUFFER_INPUT 搭配讀取器使用時，此函式是「無作業」。

藉由指定 WS_ASYNC_CONTEXT ，數據會以異步方式讀取。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll