Compartilhar via

Função WsReadNode (webservices.h)

  • Artigo

Essa operação avança o Leitor para o próximo nó no fluxo de entrada. Se houver um erro ao analisar a entrada, a função retornará WS_E_INVALID_FORMAT. (Consulte Valores retornados dos Serviços Web do Windows.)

Sintaxe

HRESULT WsReadNode(
  [in]           WS_XML_READER *reader,
  [in, optional] WS_ERROR      *error
);

Parâmetros

[in] reader

Um ponteiro para o objeto Leitor de XML a ser avançado. O ponteiro deve referenciar uma WS_XML_READER válida e pode não ser NULL.

[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 ou vários elementos de nível superior foram encontrados e WS_XML_READER_PROPERTY_ALLOW_FRAGMENT é FALSE.
WS_E_QUOTA_EXCEEDED
 Um elemento foi lido que excedeu algum limite, como WS_XML_READER_PROPERTY_MAX_DEPTH ou WS_XML_READER_PROPERTY_MAX_ATTRIBUTES.

Comentários

Outras condições de exceção incluem:

  • Se uma declaração XML for encontrada e WS_XML_READER_PROPERTY_READ_DECLARATION for FALSE, WS_E_INVALID_FORMAT será retornado.
  • Se o Leitor estiver usando WS_XML_READER_STREAM_INPUT e não houver dados suficientes armazenados em buffer, o leitor retornará WS_E_QUOTA_EXCEEDED.

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