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 |