通过

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