Compartilhar via


Função WsReadAttribute (webservices.h)

Leia um atributo que produz um valor do WS_TYPE especificado.

Sintaxe

HRESULT WsReadAttribute(
  [in]           WS_XML_READER                  *reader,
  [in]           const WS_ATTRIBUTE_DESCRIPTION *attributeDescription,
  [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 elemento que contém o atributo .

[in] attributeDescription

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

[in] readOption

Se o atributo é 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 pesquisará o atributo dado o nome e o namespace e, em seguida, desserializará o conteúdo como um valor tipado.

Se a API falhar, o estado do leitor de entrada se tornará indefinido. As únicas APIs que poderão 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