Función WsReadNode (webservices.h)

  • Artículo

Esta operación hace avanzar el lector al siguiente nodo del flujo de entrada. Si se produce un error al analizar la entrada, la función devolverá WS_E_INVALID_FORMAT. (Consulte Valores devueltos de servicios web de Windows).

Sintaxis

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

Parámetros

[in] reader

Puntero al objeto Lector XML que se va a avanzar. El puntero debe hacer referencia a un WS_XML_READER válido y puede que no sea NULL.

[in, optional] error

Puntero a un objeto WS_ERROR donde se debe almacenar información adicional sobre el error si se produce un error en la función.

Valor devuelto

Esta función puede devolver uno de estos valores.

Código devuelto Descripción
WS_E_INVALID_FORMAT
 Los datos de entrada no estaban en el formato esperado o no tenían el valor esperado, o se encontraron varios elementos de nivel superior y WS_XML_READER_PROPERTY_ALLOW_FRAGMENT es FALSE.
WS_E_QUOTA_EXCEEDED
 Se leyó un elemento que superó algún límite, como WS_XML_READER_PROPERTY_MAX_DEPTH o WS_XML_READER_PROPERTY_MAX_ATTRIBUTES.

Comentarios

Otras condiciones de excepción incluyen:

  • Si se encuentra una declaración XML y WS_XML_READER_PROPERTY_READ_DECLARATION es FALSE, se devuelve WS_E_INVALID_FORMAT .
  • Si el lector usa WS_XML_READER_STREAM_INPUT y no había suficientes datos almacenados en búfer, el lector devolverá WS_E_QUOTA_EXCEEDED.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado webservices.h
Library WebServices.lib
Archivo DLL WebServices.dll