IWSDXMLContext：：AddNamespace 方法 (wsdxml.h)

  • 發行項

建立物件，表示 XML 內容中的命名空間。 如果命名空間已經存在，則不會加入新的命名空間，而且會傳回現有名稱的命名空間物件。

語法

HRESULT AddNamespace(
  [in]  LPCWSTR          pszUri,
  [in]  LPCWSTR          pszSuggestedPrefix,
  [out] WSDXML_NAMESPACE **ppNamespace
);

參數

[in] pszUri

命名空間的 URI。

[in] pszSuggestedPrefix

產生 XML 時要使用的命名空間前置詞。 如果命名空間已經存在， pszSuggestedPrefix 將會覆寫目前與命名空間相關聯的前置詞。 XML 內容可能會指派不同的命名空間前置詞。 由 XML 內容指派的前置詞優先於建議的前置詞。 ppNamespace 所指向之結構的 PreferredPrefix 成員包含 XML 內容所指派的前置詞。

[out] ppNamespace

表示命名空間之 WSDXML_NAMESPACE 結構的位址指標。 您必須藉由呼叫 WSDFreeLinkedMemory 來解除分配 ppNamespace。 這是選擇性參數。

傳回值

可能的傳回值包括但不限於下列各項。

傳回碼 描述
S_OK
 此方法已成功。
E_INVALIDARG
 pszUri 為 NULL，URI 字串的字元長度超過 WSD_MAX_TEXT_LENGTH (8192 ) ，pszSuggestedPrefix 為 NULL，或前置字符串的字元長度超過 WSD_MAX_TEXT_LENGTH (8192) 。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
E_FAIL
 方法失敗。

備註

傳回 的WSDXML_NAMESPACE 結構可用來強制 在 pszSuggestedPrefix 所指定的命名空間前置詞 (與 pszUri 所指定的命名空間 URI) () 所指定。 建立此關聯之後，XML 產生器就會產生具有指定命名空間前置詞的 XML。

您可以呼叫 AddNamespace 來擷取由 AddNameToNamespace 呼叫自動產生命名空間時所建立的WSDXML_NAMESPACE結構。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wsdxml.h (包含 Wsdapi.h)
Dll Wsdapi.dll

另請參閱

IWSDXMLContext