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

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

  • Статья

Чтение атрибута, создающего значение указанного WS_TYPE.

Синтаксис

HRESULT WsReadAttribute(
  [in]           WS_XML_READER                  *reader,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [in]           WS_READ_OPTION                 readOption,
  [in, optional] WS_HEAP                        *heap,
                 void                           *value,
  [in]           ULONG                          valueSize,
  [in, optional] WS_ERROR                       *error
);

Параметры

[in] reader

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

[in] attributeDescription

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

[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