Поделиться через

Метод 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, имеет приоритет над предлагаемым префиксом. Элемент PreferredPrefix структуры, на который указывает ppNamespace , содержит префикс, назначенный контекстом XML.

[out] ppNamespace

Указатель на адрес структуры WSDXML_NAMESPACE , представляющей пространство имен. Необходимо освободить ppNamespace , вызвав WSDFreeLinkedMemory. Этот параметр является необязательным.

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие.

Код возврата Описание
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) и URI пространства имен (как указано в pszUri). После установки этой связи генератор XML создаст XML с указанным префиксом пространства имен.

Вы можете вызвать AddNamespace , чтобы получить структуру WSDXML_NAMESPACE , созданную при автоматическом создании пространства имен путем вызова AddNameToNamespace.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wsdxml.h (включая Wsdapi.h)
DLL Wsdapi.dll

См. также раздел

IWSDXMLContext