Share via

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 可以在 WsWriteStartAttribute 與 WsWriteEndAttribute 之間多次呼叫。 寫入屬性時，它可能不會與 WsWriteChars、 WsWriteCharsUtf8、 WsWriteValue 或 WsWriteText 結合。

針對 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