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

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

  • Статья

Записывает начальный элемент в модуль записи.

После вызова этой функции можно вызвать WsWriteStartAttribute или WsWriteXmlnsAttribute для записи дополнительных атрибутов в элемент . Элемент не фиксируется в записи, пока не будет вызван WsWriteEndElement или какая-либо другая функция, записывающая содержимое.

Синтаксис

HRESULT WsWriteStartElement(
  [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, optional] WS_ERROR            *error
);

Параметры

[in] writer

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

[in, optional] prefix

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

[in] localName

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

[in] ns

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

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

[in, optional] error

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

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

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

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

Комментарии

Если базовая кодировка поддерживает пустые элементы, а элемент не содержит содержимого, записывается пустой элемент.

Если указан непустой префикс с пустым пространством имен , WS_E_INVALID_FORMAT возвращается.

Если запись элемента start приводит к превышению WS_XML_WRITER_PROPERTY_MAX_DEPTHWS_E_QUOTA_EXCEEDED возвращается. (См. раздел Возвращаемые значения веб-служб Windows.)

При использовании WS_XML_WRITER_MTOM_ENCODING попытка записать элемент с именем localName "Include" из пространства имен является ошибкой."http://www.w3.org/2004/08/xop/include".

WsWriteStartAttribute также можно использовать для добавления атрибута к элементу, когда модуль записи расположен на элементе с помощью WsMoveWriter или WsSetWriterPosition.

Требования

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