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。 這是選擇性參數。
傳回值
可能的傳回值包括但不限於下列各項。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
pszUri 為 NULL ,或 URI 字串的字元長度超過 WSD_MAX_TEXT_LENGTH (8192) 。 pszName 為 NULL ,或名稱字串字元的長度超過 WSD_MAX_TEXT_LENGTH (8192) 。 |
|
記憶體不足,無法完成作業。 |
|
方法失敗。 |
備註
在建立可延伸區段的 XML 元素時,可以使用 AddNameToNamespace。 可延伸區段是由架構 中的任何專案表示 。 ppName 所指向的傳回WSDXML_NAME結構可用來指定與延伸模組內容相關聯的名稱。 建置代表擴充內容的WSDXML_ELEMENT結構時,請使用元素 Name 成員的傳回WSDXML_NAME結構。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wsdxml.h (包含 Wsdapi.h) |
Dll | Wsdapi.dll |