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

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

  • Статья

Считывает значение заданного WS_TYPE из XML в соответствии с WS_TYPE_MAPPING.

Синтаксис

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Параметры

[in] reader

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

[in] typeMapping

Описывает, как тип сопоставляется с считываемым XML-кодом.

[in] type

Тип десериализуемого значения.

[in, optional] typeDescription

Дополнительные сведения о типе. Каждый тип имеет разную структуру описания. Это значение может иметь значение NULL в зависимости от WS_TYPE.

[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
 Один или несколько аргументов являются недопустимыми.

Комментарии

Сведения об использовании этой функции для чтения значений из элементов и атрибутов см. в WS_TYPE_MAPPING.

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

Требования

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