共用方式為

WsWriteText 函式 (webservices.h)

  • 發行項

將指定的文字寫入 XML 寫入器。

若要將字元寫入屬性值呼叫 WsWriteStartAttribute。 除非 WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT 設定為 TRUE，否則只能在 xml 檔的根目錄中寫入空白字元。

語法

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

參數

[in] writer

寫入文字之 WS_XML_WRITER 物件的指標。 指標必須參考有效的 XML 寫入器 物件。

[in] text

要寫入之文字的指標。

注意 如需文字物件的詳細資訊，請參閱 WS_XML_TEXT 及其衍生類別。

 

[in, optional] error

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

傳回值

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

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

備註

除非文字類型是下列其中一項，否則只能在WsWriteStartAttribute與WsWriteEndAttribute 之間呼叫 WsWriteText一次：

  • WS_XML_TEXT_TYPE_UTF8
  • WS_XML_TEXT_TYPE_UTF16
  • WS_XML_TEXT_TYPE_BASE64
注意 如果文字 Type 設定為上述其中一個值 WsWriteText 可以多次呼叫。 不過，屬性內所有呼叫的文字 Type 都必須相同。
 

規格需求

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