WsWriteQualifiedName 函式 (webservices.h)

將 XML 限定名稱寫入寫入器。

語法

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

參數

[in] writer

寫入限定名稱之 WS_XML_WRITER 物件的指標。 指標必須參考有效的 XML 寫入器 物件。

[in, optional] prefix

限定名稱所使用之前置詞的WS_XML_STRING指標。 如果此參數所參考的值是 Null ，則寫入器會選擇前置詞。

[in] localName

限定名稱所使用之本機名稱的WS_XML_STRING指標。 長度至少必須有一個字元。

[in, optional] ns

用於限定名稱之命名空間的WS_XML_STRING指標。

如果未指定前置詞，則寫入器可能會在系結至指定命名空間的範圍中使用前置詞，或可能會產生前置詞並包含 XMLNS 屬性。

如果指定前置詞，則寫入器會使用該前置詞，並視需要包含 XMLNS 屬性來覆寫範圍中的現有前置詞。

[in, optional] error

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

傳回值

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

備註

• 如果前置詞為 Null，則命名空間不得為 Null。 在此情況下，寫入器會嘗試在系結至指定命名空間的範圍中找到前置詞。 如果找到適當的前置詞，則會使用。 如果不是，寫入器會產生前置詞，並在目前專案上插入 XMLNS 屬性。 如果寫入器不在 元素中，則函式會傳回 WS_E_INVALID_FORMAT。

  (請參閱 Windows Web 服務傳回值。)

• 如果前置詞不是 Null ，而且命名空間不是 Null ，則寫入器會確認前置詞目前系結至指定的命名空間，如果不是，則會傳回 WS_E_INVALID_FORMAT 。
• 如果前置詞不是 Null ，且命名空間為 Null ，則寫入器會使用前置詞和本機名稱來寫入限定名稱。

規格需求