Share via

WsReadXmlBufferFromBytes 函式 (webservices.h)

  • 發行項

使用讀取器將一組編碼的位元組轉換成 WS_XML_BUFFER。

語法

HRESULT WsReadXmlBufferFromBytes(
  [in]           WS_XML_READER                *reader,
  [in, optional] const WS_XML_READER_ENCODING *encoding,
                 const WS_XML_READER_PROPERTY *properties,
  [in]           ULONG                        propertyCount,
                 const void                   *bytes,
  [in]           ULONG                        byteCount,
  [in]           WS_HEAP                      *heap,
                 WS_XML_BUFFER                **xmlBuffer,
  [in, optional] WS_ERROR                     *error
);

參數

[in] reader

用來剖析編碼位元組的讀取器。

[in, optional] encoding

剖析位元組時要使用的編碼方式。 如果為 NULL，則會使用具有字元集WS_CHARSET_AUTO的WS_XML_READER_TEXT_ENCODING。

properties

讀取器的選擇性屬性陣列。 請參閱 WS_XML_READER_PROPERTY。

[in] propertyCount

屬性的數目。

bytes

要剖析的位元組。

[in] byteCount

要剖析的位元組數目。

[in] heap

要從中配置 XML 緩衝區的堆積。

xmlBuffer

在這裡會傳回位元組的 XML 緩衝區。

[in, optional] error

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

傳回值

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

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

備註

函式會根據指定的編碼來剖析整個內容，並將其儲存至 WS_XML_BUFFER。

呼叫此函式之後，讀取器將會處於未定義的狀態。 不過， WsReadXmlBufferFromBytes 可以再次搭配這類讀取器使用。 否則，WsSetInput 或 WsSetInputToBuffer 應該用來將讀取器帶回已知狀態，或者應該使用 WsFreeReader 釋放讀取器。

規格需求

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