Funzione di callback LPEVALCOMCALLBACK (evalcom2.h)

Articolo
02/29/2024

La specifica LPEVALCOMCALLBACK definisce un prototipo di funzione di callback. Il metodo IValidate::SetStatus consente a uno strumento di creazione di ricevere informazioni sullo stato di avanzamento della convalida tramite la funzione di callback registrata.

Sintassi

LPEVALCOMCALLBACK Lpevalcomcallback;

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

Parametri

[in] iStatus

Specifica il messaggio di stato inviato da evalcom2.

Valore	Significato
NULL	Valore di questo parametro
ieStatusICECount 1	Numero di TIC in esecuzione.
ieStatusMerge 2	Unione del pacchetto o del modulo di merge con il file con estensione cub.
ieStatusSummaryInfo 3	Unione dei flussi di informazioni di riepilogo.
ieStatusCreateEngine 4	Preparazione per l'esecuzione degli ices.
ieStatusRunICE 5	Esecuzione di un singolo ICE.
ieStatusStarting 6	Avvio della convalida.
ieStatusShutdown 7	Completare l'esecuzione degli ICEs.
ieStatusSuccess 8	Convalida completata.
ieStatusFail 9	Convalida non riuscita.
ieStatusCancel 10	La convalida è stata annullata.

szData

Valore stringa contenente le informazioni appropriate per lo stato. Il valore di szwData deve essere il numero di ices in esecuzione se iStatus è ieStatusICECount. Il valore di szwData deve essere il nome dell'oggetto ICE in esecuzione se iStatus è ieStatusRunICE. In caso contrario, il valore di szwData deve essere NULL. La funzione di callback deve accettare NULL come valore possibile per questo parametro.

pContext

Puntatore a un contesto dell'applicazione passato al metodo SetStatus . Questo parametro può essere usato per il controllo degli errori.

Valore restituito

Codice/valore restituito	Descrizione
VERO 1	La procedura di convalida deve continuare.
FALSE 0	La convalida è stata annullata. La funzione di callback restituisce FALSE per arrestare la convalida.

Commenti

Il metodo SetStatus e LPEVALCOMCALLBACK possono essere utilizzati per fornire informazioni sullo stato di avanzamento. Ad esempio, il messaggio ieStatusICECount può fornire il conteggio dei tick complessivo per un indicatore di stato. Per ogni messaggio ieStatusRunICE ricevuto, il chiamante può incrementare l'indicatore di stato un tick.