WS_READ_CALLBACK función de devolución de llamada (webservices.h)

Usado por el WS_XML_READER para leer de algún origen en un búfer.

Sintaxis

WS_READ_CALLBACK WsReadCallback;

HRESULT WsReadCallback(
  [in]           void *callbackState,
                 void *bytes,
  [in]           ULONG maxSize,
  [out]          ULONG *actualSize,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR *error
)
{...}

Parámetros

[in] callbackState

Puntero void al valor de estado definido por el usuario que se pasó a la función que aceptó esta devolución de llamada.

bytes

Puntero void a la ubicación donde se deben colocar los datos.

[in] maxSize

Número máximo de bytes que se pueden leer.

[out] actualSize

Puntero a un valor ULONG que indica el número de bytes leídos realmente. Puede ser menor que maxSize. Devolver 0 indica que no hay más datos.

[in, optional] asyncContext

Puntero a una estructura de WS_ASYNC_CONTEXT que contiene información sobre cómo invocar la función de forma asincrónica. Se asigna NULL si se invoca sincrónicamente.

[in, optional] error

Puntero a WS_ERROR estructura de datos donde se debe almacenar información de error adicional si se produce un error en la función.

Valor devuelto

Esta función de devolución de llamada no devuelve un valor.

Comentarios

Devolver el tamaño de 0 en el parámetro de salida actualSize indica el final del archivo.

Requisitos