IWSDXMLContext：：AddNameToNamespace 方法 (wsdxml.h)

  • 發行項

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

語法

HRESULT AddNameToNamespace(
  [in]  LPCWSTR     pszUri,
  [in]  LPCWSTR     pszName,
  [out] WSDXML_NAME **ppName
);

參數

[in] pszUri

要在其中建立此名稱之 XML 命名空間的 URI。 如果 XML 內容中還沒有這個命名空間，系統會自動產生新的命名空間結構。

[in] pszName

要加入至 pszUri 所指定命名空間的名稱。

[out] ppName

新建立名稱 的WSDXML_NAME 結構。 您必須藉由呼叫 WSDFreeLinkedMemory 來解除分配 ppName。 這是選擇性參數。

傳回值

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

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

備註

在建立可延伸區段的 XML 元素時，可以使用 AddNameToNamespace。 可延伸區段是由架構 中的任何專案表示 。 ppName 所指向的傳回WSDXML_NAME結構可用來指定與延伸模組內容相關聯的名稱。 建置代表擴充內容的WSDXML_ELEMENT結構時，請使用元素 Name 成員的傳回WSDXML_NAME結構。

規格需求

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

另請參閱

IWSDXMLContext