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

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

  • Статья

Записывает указанный текст в модуль записи XML.

Чтобы записать символы в значение атрибута, вызовите WsWriteStartAttribute. В корне xml-документа могут быть записаны только символы пробелов, если для WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT не задано значение TRUE.

Синтаксис

HRESULT WsWriteText(
  [in]           WS_XML_WRITER     *writer,
  [in]           const WS_XML_TEXT *text,
  [in, optional] WS_ERROR          *error
);

Параметры

[in] writer

Указатель на объект WS_XML_WRITER , в который записывается текст. Указатель должен ссылаться на допустимый объект модуля записи XML .

[in] text

Указатель на текст для записи.

Примечание Дополнительные сведения о текстовом объекте см. в разделе WS_XML_TEXT и его производных классов.

 

[in, optional] error

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

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

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

Код возврата Описание
E_INVALIDARG
 Один или несколько аргументов являются недопустимыми.
WS_E_INVALID_OPERATION
 Операция не разрешена из-за текущего состояния объекта .

Комментарии

WsWriteText можно вызывать только один раз между WsWriteStartAttribute и WsWriteEndAttribute , если только тип текста не является одним из следующих:

  • WS_XML_TEXT_TYPE_UTF8
  • WS_XML_TEXT_TYPE_UTF16
  • WS_XML_TEXT_TYPE_BASE64
Примечание Если текстовому типу задано одно из предыдущих значений, WsWriteText может вызываться несколько раз. Однако текст Type должен быть одинаковым для всех вызовов в атрибуте.
 

Требования

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