Share via

Função WsReadBytes (webservices.h)

  • Artigo

Lê o texto do Leitor e decodifica os caracteres como bytes de acordo com a especificação base64.

Sintaxe

HRESULT WsReadBytes(
  [in]           WS_XML_READER *reader,
                 void          *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 bytes devem ser lidos. O ponteiro deve referenciar um objeto WS_XML_READER válido.

bytes

Um ponteiro para um local para colocar os bytes decodificados.

[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 houver mais bytes restantes.

[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
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 um elemento final. Os comentários são ignorados e o conteúdo CDATA é tratado de forma idêntica ao conteúdo do elemento.

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

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