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

Метод IWSDXMLContext::AddNameToNamespace (wsdxml.h)

  • Статья

Создает объект , представляющий имя в пространстве имен в контексте XML. Если имя уже существует в пространстве имен, новое имя не будет добавлено, а объект name для существующего имени будет возвращен.

Синтаксис

HRESULT AddNameToNamespace(
  [in]  LPCWSTR     pszUri,
  [in]  LPCWSTR     pszName,
  [out] WSDXML_NAME **ppName
);

Параметры

[in] pszUri

Универсальный код ресурса (URI) пространства имен XML, в котором будет создано это имя. Если это пространство имен еще не существует в контексте XML, будет создана новая структура пространства имен автоматически.

[in] pszName

Имя, добавляемое в пространство имен, заданное pszUri.

[out] ppName

Структура WSDXML_NAME для созданного имени. Необходимо отменить выделение ppName путем вызова WSDFreeLinkedMemory. Этот параметр является необязательным.

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

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

Код возврата Описание
S_OK
 Метод выполнен успешно.
E_INVALIDARG
 pszUri имеет значение NULL или длина строки URI в символах превышает WSD_MAX_TEXT_LENGTH (8192). pszName имеет значение NULL или длина строки имени в символах превышает WSD_MAX_TEXT_LENGTH (8192).
E_OUTOFMEMORY
 Недостаточно памяти для завершения операции.
E_FAIL
 Сбой метода.

Комментарии

AddNameToNamespace можно использовать при создании XML-элементов для расширяемых разделов. Расширяемые разделы представлены любым элементом в схеме. Возвращаемую структуру WSDXML_NAME , на которую указывает ppName, можно использовать для указания имени, связанного с содержимым расширения. При создании структуры WSDXML_ELEMENT , представляющей содержимое расширения, используйте возвращаемую структуру WSDXML_NAME для элемента Name .

Требования

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

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

IWSDXMLContext