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

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

  • Статья

Эта операция начинает запись атрибута в текущий элемент. Перед записью атрибута необходимо вызвать WsWriteStartElement. После запуска атрибута его значение можно записать с помощью WsWriteChars, WsWriteBytes или WsWriteValue. Атрибут должен быть заполнен с помощью WsWriteEndAttribute.

Синтаксис

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

Параметры

[in] writer

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

[in, optional] prefix

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

[in] localName

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

[in] ns

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

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

Если указан префикс, модуль записи будет использовать этот префикс и при необходимости может включать атрибут XMLNS для переопределения существующего префикса в область.

[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 , модуль записи выберет префикс для пространства имен.

Чтобы написать атрибут "xml:lang" или "xml:space", укажите "xml" для префикса, "lang" или "space" для localName и "http://www.w3.org/XML/1998/namespace" для пространства имен.

Если запись атрибута приводит к превышению WS_XML_WRITER_PROPERTY_MAX_ATTRIBUTES , возвращается WS_E_QUOTA_EXCEEDED .

Если указан непустой префикс с пустым пространством имен , WS_E_INVALID_FORMAT возвращается. (См. раздел Возвращаемые значения веб-служб Windows.)

Требования

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