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

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

  • Статья

Чтение элемента, создающего значение указанного WS_TYPE.

Синтаксис

HRESULT WsReadElement(
  [in]           WS_XML_READER                *reader,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [in]           WS_READ_OPTION               readOption,
  [in, optional] WS_HEAP                      *heap,
                 void                         *value,
  [in]           ULONG                        valueSize,
  [in, optional] WS_ERROR                     *error
);

Параметры

[in] reader

Средство чтения, размещенное в XML для десериализации.

[in] elementDescription

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

[in] readOption

Является ли элемент обязательным и как выделить значение.
Дополнительные сведения см. в разделе WS_READ_OPTION .

[in, optional] heap

Куча для хранения десериализованных значений.

value

Интерпретация этого параметра зависит от WS_READ_OPTION.

[in] valueSize

Интерпретация этого параметра зависит от WS_READ_OPTION.

[in, optional] error

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

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

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

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

Комментарии

Этот API переместится к следующему элементу, проверит его имя и пространство имен, а затем десериализует содержимое как типизированное значение.

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

Требования

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