共用方式為


WsWriteBytes 函式 (webservices.h)

以針對編碼優化的格式,將位元組寫入寫入器。 以文字編碼撰寫時,它會發出以base64編碼的位元組。 寫入二進位格式時,它會直接發出位元組。

語法

HRESULT WsWriteBytes(
  [in]           WS_XML_WRITER *writer,
                 const void    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

參數

[in] writer

要寫入位元組的寫入器。

bytes

要寫入檔的位元組。

[in] byteCount

要寫入檔的位元元組數。

[in, optional] error

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

傳回值

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

傳回碼 Description
E_INVALIDARG
一或多個引數無效。
WS_E_INVALID_OPERATION
由於物件的目前狀態,不允許此作業。
WS_E_QUOTA_EXCEEDED
超過配額。

備註

WsWriteBytes 可以在 WsWriteStartAttributeWsWriteEndAttribute 之間多次呼叫。 寫入屬性時,它可能不會與 WsWriteCharsWsWriteCharsUtf8WsWriteValueWsWriteText 結合。

針對 WS_XML_WRITER_MTOM_ENCODING,如果 byteCount 超過 WsSetOutput 期間指定的 maxInlineByteCount,則會緩衝處理位元組,並將其放在自己的 MIME 元件中。 否則,位元節會編碼在base64中,並直接放在檔中。

針對 WS_XML_WRITER_MTOM_ENCODING,如果包含位元組的專案具有名稱為 『contentType』 和命名空間 『http://www.w3.org/2004/11/xmlmime' 的屬性,則屬性的值將會反映在 MIME 元件的內容類型標頭中,如 XML 二進位優化封裝中所述。

規格需求

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