Funzione di callback LPEVALCOMCALLBACK (evalcom2.h)

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

Value	Meaning
NULL	Valore di questo parametro
ieStatusICECount 1	Numero di ices in esecuzione.
ieStatusMerge 2	Unione del pacchetto o del modulo di merge con il file con estensione cub.
ieStatusSummaryInfo 3	Unione di 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 correttamente.
ieStatusFail 9	Convalida non riuscita.
ieStatusCancel 10	La convalida è stata annullata.

szData

Valore stringa contenente 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'esecuzione ICE 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	Description
TRUE 1	La procedura di convalida deve continuare.
FALSE 0	La convalida è stata annullata. La funzione di callback restituisce FALSE per arrestare la convalida.

Osservazioni:

È possibile utilizzare il metodo SetStatus e LPEVALCOMCALLBACK 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 segno di graduazione.

Requisiti

Requisito	Value
Client minimo supportato	Evalcom2.dll versione 3.0.3790.371 o successiva
Piattaforma di destinazione	Windows
Header	evalcom2.h

Vedere anche

IValidate

Uso di Evalcom2

Funzioni di callback di convalida