共用方式為


WsPushBytes 函式 (webservices.h)

建立要叫用的回呼,以寫入元素內的位元組。 在某些編碼中,藉由消除資料的複本,這可以更有效率。

語法

HRESULT WsPushBytes(
  [in]           WS_XML_WRITER          *writer,
  [in]           WS_PUSH_BYTES_CALLBACK callback,
  [in, optional] void                   *callbackState,
  [in, optional] WS_ERROR               *error
);

參數

[in] writer

要寫入位元組之 XML 寫入器物件的指標。 指標必須參考有效的 WS_XML_WRITER ,而且參考的值可能不是 Null

[in] callback

此參數是要叫用以寫入資料的回呼。

[in, optional] callbackState

傳遞至回呼函式之使用者定義狀態的指標。

[in, optional] error

WS_ERROR物件的指標,如果函式失敗,應該儲存錯誤的其他資訊。

傳回值

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

傳回碼 描述
E_INVALIDARG
一或多個引數無效。
WS_E_INVALID_OPERATION
由於 物件的目前狀態,不允許此作業。

備註

使用 WS_XML_WRITER_MTOM_ENCODING進行寫入時, WsPushBytes 提供一種方式,將位元組直接寫入自己的 MIME 元件,並避免複製。 不過,寫入器可以自行選擇立即叫用回呼,因此應該為此準備呼叫端。

如果編碼無法利用此行為, 則 WsPushBytes 會立即叫用回呼,並如同呼叫 WsWriteBytes 一樣運作。

規格需求

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