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
pszUriNULL ,或者 URI 字符串的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) 。 pszNameNULL 或名称字符串的长度(以字符为单位)超过 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