Función de devolución de llamada LPEVALCOMCALLBACK (evalcom2.h)

Artículo
02/26/2024

La especificación LPEVALCOMCALLBACK define un prototipo de función de devolución de llamada. El método IValidate::SetStatus permite a una herramienta de creación recibir información sobre el progreso de la validación a través de la función de devolución de llamada registrada.

Sintaxis

LPEVALCOMCALLBACK Lpevalcomcallback;

BOOL Lpevalcomcallback(
  [in] STATUSTYPES iStatus,
       LPCWSTR szData,
       LPVOID pContext
)
{...}

Parámetros

[in] iStatus

Especifica el mensaje de estado enviado por evalcom2.

Valor	Significado
NULL	Valor de este parámetro
ieStatusICECount 1	Número de ICE que se están ejecutando.
ieStatusMerge 2	Combinar el paquete o el módulo de combinación con el archivo .cub.
ieStatusSummaryInfo 3	Combinación de flujos de información de resumen.
ieStatusCreateEngine 4	Preparación para ejecutar los ICE.
ieStatusRunICE 5	Ejecutar un ICE individual.
ieStatusStarting 6	Inicio de la validación.
ieStatusShutdown 7	Termine de ejecutar las ICE.
ieStatusSuccess 8	La validación se completó correctamente.
ieStatusFail 9	Error de validación.
ieStatusCancel 10	Se canceló la validación.

szData

Valor de cadena que contiene información adecuada para el estado. El valor de szwData debe ser el número de ICEs que se ejecutan si iStatus es ieStatusICECount. El valor de szwData debe ser el nombre del ICE que se ejecuta si iStatus es ieStatusRunICE. De lo contrario, el valor de szwData debe ser NULL. La función de devolución de llamada debe aceptar NULL como un valor posible para este parámetro.

pContext

Puntero a un contexto de aplicación pasado al método SetStatus . Este parámetro se puede usar para la comprobación de errores.

Valor devuelto

Código o valor devuelto	Descripción
VERDAD 1	El procedimiento de validación debe continuar.
FALSO 0	Se canceló la validación. La función de devolución de llamada devuelve FALSE para detener la validación.

Comentarios

El método SetStatus y LPEVALCOMCALLBACK se pueden usar para proporcionar información de progreso. Por ejemplo, el mensaje ieStatusICECount puede proporcionar el recuento general de tics para una barra de progreso. Para cada mensaje ieStatusRunICE recibido, el autor de la llamada puede incrementar la barra de progreso un tic.