Compartilhar via

Função WsWriteCharsUtf8 (webservices.h)

  • Artigo

Grava uma série de caracteres codificados como UTF-8 em um elemento ou atributo. Para gravar caracteres em um valor de atributo, chame WsWriteStartAttribute primeiro. Somente caracteres de espaço em branco podem ser gravados na raiz de um documento xml, a menos que o WS_XML_WRITER_PROPERTY_ALLOW_FRAGMENT tenha sido definido como TRUE.

Sintaxe

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

Parâmetros

[in] writer

Um ponteiro para o objeto WS_XML_WRITER ao qual os caracteres são gravados. O ponteiro deve referenciar um objeto gravador XML válido.

bytes

Um ponteiro para os caracteres UTF-8 codificados a serem gravados.

[in] byteCount

O número de bytes a serem gravados.

[in, optional] error

Um ponteiro para um objeto WS_ERROR em que informações adicionais sobre o erro devem ser armazenadas se a função falhar.

Valor retornado

Essa função pode retornar um desses valores.

Código de retorno Descrição
E_INVALIDARG
 Um ou mais argumentos são inválidos.
WS_E_INVALID_OPERATION
 A operação não é permitida devido ao estado atual do objeto.

Comentários

WsWriteCharsUtf8 pode ser chamado mais de uma vez entre WsWriteStartAttribute e WsWriteEndAttribute. Ele não pode ser combinado com WsWriteChars, WsWriteBytes, WsWriteValue ou WsWriteText ao escrever um atributo.

Requisitos

   
Cliente mínimo com suporte Windows 7 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho webservices.h
Biblioteca WebServices.lib
DLL WebServices.dll