Compartilhar via

Função WsReadElement (webservices.h)

  • Artigo

Leia um elemento que produz um valor do WS_TYPE especificado.

Sintaxe

HRESULT WsReadElement(
  [in]           WS_XML_READER                *reader,
  [in]           const WS_ELEMENT_DESCRIPTION *elementDescription,
  [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] elementDescription

Um ponteiro para uma descrição de como desserializar o elemento.

[in] readOption

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

[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

Essa API passará para o próximo elemento, verificará seu nome e namespace e, em seguida, desserializará o conteúdo como um valor digitado.

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