Compartilhar via

Função WsReadStartAttribute (webservices.h)

  • Artigo

Move o Leitor para o atributo especificado para que o conteúdo possa ser lido usando WsReadValue, WsReadChars ou WsReadBytes.

Se o leitor não estiver posicionado em um elemento start, ele retornará uma exceção WS_E_INVALID_FORMAT .

(Consulte Valores retornados dos Serviços Web do Windows.)

Nota Os atributos lidos não aparecem em nenhuma ordem específica. WsFindAttribute pode ser usado para localizar o índice de um atributo específico.

 

Sintaxe

HRESULT WsReadStartAttribute(
  [in]           WS_XML_READER *reader,
  [in]           ULONG         attributeIndex,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] reader

Um ponteiro para o objeto Leitor XML usado para ler o atributo Start.

[in] attributeIndex

O índice do atributo a ser lido.

[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.

Comentários

A função WsReadNode retorna EOF quando avançado dentro de um atributo. A função WsReadEndAttribute pode ser usada para retornar o leitor ao elemento que contém.

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