WsWriteStartElement 函式 (webservices.h)

將開始專案寫入寫入器。

呼叫此函式 之後，可以呼叫 WsWriteStartAttribute 或 WsWriteXmlnsAttribute ，以將其他屬性寫入元素。 在 呼叫寫入內容的 WsWriteEndElement 或其他函式之前，專案不會認可至寫入器。

語法

HRESULT WsWriteStartElement(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *localName,
  [in]           const WS_XML_STRING *ns,
  [in, optional] WS_ERROR            *error
);

參數

[in] writer

寫入起始專案 之WS_XML_WRITER 物件的指標。 指標必須參考有效的 XML 寫入器 物件。

[in, optional] prefix

要用於 start 元素之前置詞的WS_XML_STRING指標。 如果此參數所參考的值是 NULL ，寫入器會選擇屬性。

[in] localName

WS_XML_STRING start 元素所使用的本機名稱指標。 它必須至少有一個字元長。

[in] ns

要用於 start 元素之命名空間的WS_XML_STRING指標。

如果未指定前置詞，寫入器可能會在系結至指定命名空間的範圍中使用前置詞，或者它可能會產生前置詞並包含 XMLNS 屬性。 如果指定前置詞，寫入器會使用該前置詞，並視需要包含 XMLNS 屬性來覆寫範圍中的現有前置詞。

[in, optional] error

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

傳回值

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

備註

如果基礎編碼支援空白專案，而且項目沒有寫入空白項目的內容。

如果以空命名空間指定非空白前置詞 ，則會傳回WS_E_INVALID_FORMAT 。

如果寫入開始 元素會導致傳 回 WS_E_QUOTA_EXCEEDED超過WS_XML_WRITER_PROPERTY_MAX_DEPTH 。 (請參閱 Windows Web 服務傳回值。)

使用 WS_XML_WRITER_MTOM_ENCODING 嘗試從命名空間http://www.w3.org/2004/08/xop/include"寫入 localName “Include” 的項目時發生錯誤。

當寫入器位於使用 WsMoveWriter 或 WsSetWriterPosition 的元素上時，WsWriteStartAttribute 也可以用來將屬性新增至專案。

規格需求