Función WsFillReader (webservices.h)

Garantiza que el lector haya almacenado en búfer el recuento mínimo de bytes de datos XML para su uso por las funciones de lector posteriores. Invocará la devolución de llamada especificada por WS_XML_READER_STREAM_INPUT tantas veces como sea necesario para obtener el número de bytes especificado por el valor del parámetro minSize . Al finalizar, los datos almacenados en búfer están disponibles para otras funciones de lector. Si una función lector posterior requiere más datos de los que se han obtenido, la función devolverá una excepción WS_E_QUOTA_EXCEEDED . (Vea Valores devueltos de servicios web de Windows).

Sintaxis

HRESULT WsFillReader(
  [in]           WS_XML_READER          *reader,
  [in]           ULONG                  minSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

Parámetros

[in] reader

Puntero a una estructura WS_XML_READER utilizada para obtener los datos.

[in] minSize

Especifica el número mínimo de bytes que el lector debe haber obtenido. Si el recuento de bytes actual almacenado en búfer es igual o mayor que el valor de minSize , la función no hará nada y devolverá inmediatamente.

[in, optional] asyncContext

Puntero a una estructura de datos WS_ASYNC_CONTEXT con información sobre cómo invocar la función de forma asincrónica. Un valor NULL indica una solicitud de operación sincrónica.

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

Comentarios

El número de bytes necesarios para leer un segmento determinado de datos XML depende de la codificación y su formato.

Esta función es una "sin operación" cuando se usa con un lector mediante WS_XML_READER_BUFFER_INPUT.

Al especificar un WS_ASYNC_CONTEXT los datos se leen de forma asincrónica.

Requisitos