共用方式為

WsReadCharsUtf8 函式 (webservices.h)

  • 發行項

從讀取器讀取指定的文字字元數目，並傳回以UTF-8編碼的文字字元。

語法

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

參數

[in] reader

要從中讀取字元數據的 XML 讀取器 指標。 指標必須參考有效的 WS_XML_READER 物件。

bytes

緩衝區的指標，用來放置已讀取的編碼位元組。

[in] maxByteCount

應該讀取的最大位元元組數目。

[out] actualByteCount

已讀取之實際位元組數目之ULONG值的指標。 即使剩餘更多位元組，這也可能小於 maxByteCount。 當這個 傳回零時，不會再有位元組。

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_INVALID_FORMAT
 輸入數據不是預期的格式，或沒有預期的值。
WS_E_QUOTA_EXCEEDED
 超過配額。

備註

XML 文字會讀取到 start 元素或 end 元素。 略過批注，CDATA 內容會與元素內容相同。 字元實體會轉換成其未逸出的形式。

此函式可能會因為 WsReadNode 中列出的任何原因而失敗。

規格需求

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