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


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

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

Синтаксис

HRESULT WsWriteCharsUtf8(
  [in]           WS_XML_WRITER *writer,
                 const BYTE    *bytes,
  [in]           ULONG         byteCount,
  [in, optional] WS_ERROR      *error
);

Параметры

[in] writer

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

bytes

Указатель на кодированные символы UTF-8 для записи.

[in] byteCount

Количество записываемых байтов.

[in, optional] error

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

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

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

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

Комментарии

WsWriteCharsUtf8 можно вызывать несколько раз между WsWriteStartAttribute и WsWriteEndAttribute. При написании атрибута его нельзя сочетать с WsWriteChars, WsWriteBytes, WsWriteValue или WsWriteText .

Требования

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