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

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

  • Статья

Запись значения заданного WS_TYPE в XML в соответствии с WS_TYPE_MAPPING.

Синтаксис

HRESULT WsWriteType(
  [in]           WS_XML_WRITER   *writer,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_WRITE_OPTION writeOption,
                 const void      *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Параметры

[in] writer

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

[in] typeMapping

Описывает, как тип сопоставляется с xml-кодом, который записывается.

[in] type

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

[in, optional] typeDescription

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

[in] writeOption

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

Этот параметр должен иметь одно из следующих значений:

value

Указатель на сериализуемое значение.

[in] valueSize

Размер сериализуемого значения.

[in, optional] error

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

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

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

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

Комментарии

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

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

Требования

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