WsFlushWriter 函式 (webservices.h)

  • 發行項

指示寫入器叫用WS_XML_WRITER_STREAM_OUTPUT中指定的回呼，如果已緩衝足夠的資料。

語法

HRESULT WsFlushWriter(
  [in]           WS_XML_WRITER          *writer,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

參數

[in] writer

要排清的寫入器。

[in] minSize

指定必須緩衝處理的位元組數目下限，以便叫用回 呼 。 如果緩衝的位元組數目少於這個數目，則不會叫用 回呼 。 這可用來將寫入少量資料時所發生的 i/o 數目降到最低。

應該指定零，以確保叫用 回呼 。

[in, optional] asyncContext

如何以非同步方式叫用函式的資訊，如果以同步方式叫用，則為 Null 。

[in, optional] error

指定函式失敗時應儲存其他錯誤資訊的位置。

傳回值

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

傳回碼 描述
E_INVALIDARG
 一或多個引數無效。
WS_S_ASYNC
 非同步作業仍在擱置中。

備註

寫入器會緩衝所有資料，直到 呼叫 WsFlushWriter 為止。

如有必要，應該在WsFreeWriter 之前呼叫 WsFlushWriter，以確保發出所有資料。

藉由指定 WS_ASYNC_CONTEXT 緩衝處理的資料將會以非同步方式寫入。

如果寫入器正在使用 WS_XML_WRITER_BUFFER_OUTPUT，則此函式為無作業。

如果已呼叫 WsWriteStartElement ，但尚未認可元素 (請參閱 WsWriteStartElement) ，則不會排清這個專案。

如果在使用 WS_XML_WRITER_MTOM_ENCODING 時呼叫此函式 ， 而且寫入器上沒有開啟的元素，則會產生及發出支援的 MIME 元件。 一旦發生這種情況，嘗試進一步寫入 XML 檔的任何 API 都會傳回 WS_E_INVALID_OPERATION。 (請參閱 Windows Web 服務傳回值。)

規格需求

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