LPEVALCOMCALLBACK-Rückruffunktion (evalcom2.h)

Artikel
02/26/2024

Die LPEVALCOMCALLBACK-Spezifikation definiert einen Rückruffunktionsprototyp. Die IValidate::SetStatus-Methode ermöglicht es einem Erstellungstool, Informationen über den Status der Überprüfung über die registrierte Rückruffunktion zu erhalten.

Syntax

LPEVALCOMCALLBACK Lpevalcomcallback;

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

Parameter

[in] iStatus

Gibt die status Nachricht an, die von evalcom2 gesendet wird.

Wert	Bedeutung
NULL	Der Wert dieses Param
ieStatusICECount 1	Anzahl der icEs, die ausgeführt werden.
ieStatusMerge 2	Zusammenführen des Pakets oder Mergemoduls mit der CUB-Datei.
ieStatusSummaryInfo 3	Zusammenführen von Zusammenfassungsinformationsstreams.
ieStatusCreateEngine 4	Vorbereiten der Ausführung der ICEs.
ieStatusRunICE 5	Ausführen eines einzelnen ICE.
ieStatusStarting 6	Starten der Validierung.
ieStatusShutdown 7	Beenden Sie die Ausführung der ICEs.
ieStatusSuccess 8	Die Überprüfung wurde erfolgreich abgeschlossen.
ieStatusFail 9	Fehler bei der Überprüfung.
ieStatusCancel 10	Die Überprüfung wurde abgebrochen.

szData

Ein Zeichenfolgenwert, der informationen enthält, die für die status geeignet sind. Der Wert von szwData sollte die Anzahl der ICEs sein, die ausgeführt werden, wenn iStatus ieStatusICECount ist. Der Wert von szwData sollte der Name des ice sein, der ausgeführt wird, wenn iStatus auf ieStatusRunICE festgelegt ist. Andernfalls sollte der Wert von szwDataNULL sein. Die Rückruffunktion sollte NULL als möglichen Wert für diesen Parameter akzeptieren.

pContext

Zeiger auf einen Anwendungskontext, der an die SetStatus-Methode übergeben wird. Dieser Parameter kann für die Fehlerüberprüfung verwendet werden.

Rückgabewert

Rückgabecode/-wert	BESCHREIBUNG
STIMMT 1	Die Überprüfung sollte fortgesetzt werden.
FALSE 0	Die Überprüfung wurde abgebrochen. Die Rückruffunktion gibt FALSE zurück, um die Überprüfung zu beenden.

Hinweise

Die SetStatus-Methode und LPEVALCOMCALLBACK können verwendet werden, um Statusinformationen bereitzustellen. Beispielsweise kann die ieStatusICECount-Nachricht die Gesamtanzahl von Teilstrichen für eine Statusanzeige angeben. Für jede empfangene ieStatusRunICE-Nachricht kann der Aufrufer die Statusanzeige um einen Tick erhöhen.