Compartilhar via

Função WsReadChars (webservices.h)

  • Artigo

Lê um número especificado de caracteres de texto do Leitor.

Sintaxe

HRESULT WsReadChars(
  [in]           WS_XML_READER *reader,
                 WCHAR         *chars,
  [in]           ULONG         maxCharCount,
  [out]          ULONG         *actualCharCount,
  [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.

chars

Um ponteiro para um local para os caracteres que foram lidos.

[in] maxCharCount

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

[out] actualCharCount

Um ponteiro para um valor ULONG do número real de caracteres que foram lidos. Isso pode ser menor que maxCharCount mesmo quando há mais caracteres restantes. Não há mais caracteres 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 é 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