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

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

  • Статья

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

Синтаксис

HRESULT WsWriteAttribute(
  [in]           WS_XML_WRITER                  *writer,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_WRITE_OPTION                writeOption,
                 const void                     *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

Параметры

[in] writer

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

[in] attributeDescription

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

[in] writeOption

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

value

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

[in] valueSize

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

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

[in, optional] error

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

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

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

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

Комментарии

Этот API записывает атрибут start, значение атрибута и атрибут end.

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

Требования

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