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

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

  • Статья

Запись типизированного значения в виде XML-элемента.

Синтаксис

HRESULT WsWriteElement(
  [in]           WS_XML_WRITER                *writer,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_WRITE_OPTION              writeOption,
                 const void                   *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

Параметры

[in] writer

Модуль записи, в который записывается элемент.

[in] elementDescription

Указатель на описание сериализации элемента.

[in] writeOption

Сведения о выделении значения. Дополнительные сведения см. в разделе WS_WRITE_OPTION .

value

Указатель на значение для сериализации.

[in] valueSize

Размер сериализуемого значения в байтах.

Если значение равно NULL, размер должен быть равен 0.

[in, optional] error

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

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

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

Код возврата Описание
WS_E_INVALID_FORMAT
 Входные данные не были в ожидаемом формате или не имели ожидаемого значения.
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
E_OUTOFMEMORY
 Не хватает памяти.

Комментарии

Этот API записывает начальный элемент, атрибуты, дочерние элементы / текст и конечный элемент, соответствующий указанному значению.

В случае сбоя API состояние записи входных данных становится неопределенным. Единственные API, которые можно использовать в записи, если это происходит, — это WsSetOutput и WsSetOutputToBuffer , чтобы вернуть модуль записи в пригодное для использования состояние, или WsFreeWriter для освобождения модуля записи.

Требования

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