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

Функция WsWriteXmlnsAttribute (webservices.h)

  • Статья

Записывает атрибут Xmlns в текущий элемент . Перед записью атрибута необходимо вызвать WsWriteStartElement. Если число атрибутов превышает максимально допустимое для модуля записи число атрибутов, функция возвращает WS_E_QUOTA_EXCEEDED. (См. раздел Возвращаемые значения веб-служб Windows.)

Синтаксис

HRESULT WsWriteXmlnsAttribute(
  [in]           WS_XML_WRITER       *writer,
  [in, optional] const WS_XML_STRING *prefix,
  [in]           const WS_XML_STRING *ns,
  [in]           BOOL                singleQuote,
  [in, optional] WS_ERROR            *error
);

Параметры

[in] writer

Указатель на объект WS_XML_WRITER , в который записывается атрибут Xmlns. Указатель должен ссылаться на допустимый объект модуля записи XML .

[in, optional] prefix

Указатель WS_XML_STRING на префикс, используемый для элемента start. Если значение, на которое ссылается этот параметр, равно NULL , модуль записи выберет атрибут .

Указывает префикс, используемый для атрибута xmlns.

[in] ns

Указатель WS_XML_STRING на пространство имен для привязки к префиксу.

[in] singleQuote

Определяет, следует ли использовать одинарные или двойные кавычки для значения атрибута.

Примечание Если задано WS_XML_WRITER_BINARY_ENCODING , символ кавычки не сохраняется и этот параметр не действует.

 

[in, optional] error

Указатель на объект WS_ERROR , в котором должны храниться дополнительные сведения об ошибке в случае сбоя функции.

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

Эта функция может возвращать одно из этих значений.

Код возврата Описание
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
WS_E_INVALID_OPERATION
 Операция не разрешена из-за текущего состояния объекта .
WS_E_INVALID_FORMAT
 Входные данные не были в ожидаемом формате или не имели ожидаемого значения.
WS_E_QUOTA_EXCEEDED
 Превышена квота.

Комментарии

Применяются следующие условия:

  • Если указан пустой префикс, то назначается пространство имен по умолчанию.
  • Если указан префикс NULL , модуль записи выбирает соответствующий префикс для пространства имен.
  • Если атрибут Xmlns является избыточным, он не может быть записан.
  • Если указан непустой префикс с пустым пространством имен , WS_E_INVALID_FORMAT возвращается.

Требования

Требование Значение
Минимальная версия клиента Windows 7 [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header webservices.h
Библиотека WebServices.lib
DLL WebServices.dll