Compartilhar via

Função WsReadType (webservices.h)

  • Artigo

Leia um valor de um determinado WS_TYPE de XML de acordo com o WS_TYPE_MAPPING.

Sintaxe

HRESULT WsReadType(
  [in]           WS_XML_READER   *reader,
  [in]           WS_TYPE_MAPPING typeMapping,
  [in]           WS_TYPE         type,
  [in, optional] const void      *typeDescription,
  [in]           WS_READ_OPTION  readOption,
  [in, optional] WS_HEAP         *heap,
                 void            *value,
  [in]           ULONG           valueSize,
  [in, optional] WS_ERROR        *error
);

Parâmetros

[in] reader

O leitor posicionado no XML para desserializar.

[in] typeMapping

Descreve como o tipo é mapeado para o XML que está sendo lido.

[in] type

O tipo do valor a ser desserializado.

[in, optional] typeDescription

Informações adicionais sobre o tipo. Cada tipo tem uma estrutura de descrição diferente. Isso pode ser NULL, dependendo do WS_TYPE.

[in] readOption

Se o valor é necessário e como alocar o valor. Consulte WS_READ_OPTION para obter mais informações.

Esse parâmetro pode ter um dos seguintes valores:

[in, optional] heap

O heap no qual armazenar os valores desserializados.

value

A interpretação desse parâmetro depende do WS_READ_OPTION.

[in] valueSize

A interpretação desse parâmetro depende do WS_READ_OPTION.

[in, optional] error

Especifica onde informações adicionais de 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.
E_OUTOFMEMORY
 Ficou sem memória.
WS_E_QUOTA_EXCEEDED
 A cota de tamanho do heap foi excedida.
E_INVALIDARG
 Um ou mais argumentos são inválidos.

Comentários

Consulte WS_TYPE_MAPPING como usar essa função para ler valores de elementos e atributos.

Se a API falhar, o estado do leitor de entrada ficará indefinido. As únicas APIs que podem ser usadas no leitor se isso ocorrer são WsSetInput e WsSetInputToBuffer para retornar o leitor a um estado utilizável ou WsFreeReader para liberar o leitor.

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