Fonction de rappel LPEVALCOMCALLBACK (evalcom2.h)

Article
03/04/2024

La spécification LPEVALCOMCALLBACK définit un prototype de fonction de rappel. La méthode IValidate ::SetStatus permet à un outil de création de recevoir des informations sur la progression de la validation via la fonction de rappel inscrite.

Syntaxe

LPEVALCOMCALLBACK Lpevalcomcallback;

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

Paramètres

[in] iStatus

Spécifie le message status envoyé par evalcom2.

Valeur	Signification
NULL	Valeur de ce paramètre
ieStatusICECount 1	Nombre d’ICE en cours d’exécution.
ieStatusMerge 2	Fusion du package ou du module de fusion avec le fichier .cub.
ieStatusSummaryInfo 3	Fusion de flux d’informations récapitulatives.
ieStatusCreateEngine 4	Préparation de l’exécution des ICE.
ieStatusRunICE 5	Exécution d’un ICE individuel.
ieStatusStarting 6	Démarrage de la validation.
ieStatusShutdown 7	Terminez l’exécution des ICE.
ieStatusSuccess 8	La validation s’est terminée avec succès.
ieStatusFail 9	Échec de la validation.
ieStatusCancel 10	La validation a été annulée.

szData

Valeur de chaîne contenant des informations appropriées au status. La valeur de szwData doit être le nombre d’ICE en cours d’exécution si iStatus est ieStatusICECount. La valeur de szwData doit être le nom de l’ice en cours d’exécution si iStatus est ieStatusRunICE. Sinon, la valeur de szwData doit être NULL. La fonction de rappel doit accepter NULL comme valeur possible pour ce paramètre.

pContext

Pointeur vers un contexte d’application passé à la méthode SetStatus . Ce paramètre peut être utilisé pour la vérification des erreurs.

Valeur retournée

Code/valeur de retour	Description
VRAI 1	La procédure de validation doit continuer.
FAUX 0	La validation a été annulée. La fonction de rappel retourne FALSE pour arrêter la validation.

Remarques

La méthode SetStatus et LPEVALCOMCALLBACK peuvent être utilisées pour fournir des informations sur la progression. Par exemple, le message ieStatusICECount peut fournir le nombre total de graduations pour une barre de progression. Pour chaque message ieStatusRunICE reçu, l’appelant peut incrémenter la barre de progression d’une graduation.