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 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.
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 |
---|---|
|
La procedura di convalida deve continuare. |
|
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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Evalcom2.dll versione 3.0.3790.371 o successiva |
Piattaforma di destinazione | Windows |
Intestazione | evalcom2.h |