Compartilhar via

Função WsReadCharsUtf8 (webservices.h)

  • Artigo

Lê um número especificado de caracteres de texto do leitor e os retorna codificados em UTF-8.

Sintaxe

HRESULT WsReadCharsUtf8(
  [in]           WS_XML_READER *reader,
                 BYTE          *bytes,
  [in]           ULONG         maxByteCount,
  [out]          ULONG         *actualByteCount,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] reader

Um ponteiro para o Leitor XML do qual os dados de caractere devem ser lidos. O ponteiro deve referenciar um objeto WS_XML_READER válido.

bytes

Um ponteiro para o buffer para colocar os bytes codificados que foram lidos.

[in] maxByteCount

O número máximo de bytes que devem ser lidos.

[out] actualByteCount

Um ponteiro para um valor ULONG do número real de bytes que foram lidos. Isso pode ser menor que maxByteCount mesmo quando há mais bytes restantes. Não há mais bytes quando isso retorna zero.

[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.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
WS_E_INVALID_FORMAT
 Os dados de entrada não estavam no formato esperado ou não tinham o valor esperado.
WS_E_QUOTA_EXCEEDED
 Uma cota foi excedida.

Comentários

O texto XML é lido até um elemento inicial ou elemento final. Os comentários são ignorados e o conteúdo cdata é tratado de forma idêntica ao conteúdo do elemento. As entidades de caractere são convertidas em sua forma sem escape.

Essa função pode falhar por qualquer um dos motivos listados no WsReadNode.

Requisitos

Requisito Valor
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