LPEVALCOMCALLBACK 回调函数 (evalcom2.h)

LPEVALCOMCALLBACK 规范定义回调函数原型。 IValidate::SetStatus 方法使创作工具能够通过注册的回调函数接收有关验证进度的信息。

Syntax

LPEVALCOMCALLBACK Lpevalcomcallback;

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

参数

[in] iStatus

指定 evalcom2 发送的状态消息。

价值 Meaning
NULL
此参数的值
ieStatusICECount
1
正在运行的 ICE 数。
ieStatusMerge
2
将包或合并模块与 .cub 文件合并。
ieStatusSummaryInfo
3
合并摘要信息流。
ieStatusCreateEngine
4
准备运行 ICE。
ieStatusRunICE
5
运行单个 ICE。
ieStatusStarting
6
开始验证。
ieStatusShutdown
7
完成 ICE 的运行。
ieStatusSuccess
8
验证成功完成。
ieStatusFail
9
验证失败。
ieStatusCancel
10
验证已取消。

szData

一个字符串值,该值包含与状态相对应的信息。 如果 iStatus 为 ieStatusICECount,则 szwData 的值应为正在运行的 ICE 数。 如果 iStatus 为 ieStatusRunICE则 szwData 的值应为正在运行的 ICE 的名称。 否则, szwData 的值应为 NULL。 回调函数应接受 NULL 作为此参数的可能值。

pContext

指向传递给 SetStatus 方法的应用程序上下文的指针。 此参数可用于错误检查。

返回值

返回代码/值 Description
TRUE
1
验证过程应继续。
FALSE
0
验证已取消。 回调函数返回 FALSE 以停止验证。

注解

SetStatus 方法和 LPEVALCOMCALLBACK 可用于提供进度信息。 例如, ieStatusICECount 消息可以提供进度栏的总体刻度计数。 对于收到的每个 ieStatusRunICE 消息,调用方可以递增进度栏一刻度。

要求

Requirement 价值
最低支持的客户端 Evalcom2.dll 版本 3.0.3790.371 或更高版本
目标平台 Windows操作系统
Header evalcom2.h

另请参阅

IValidate

使用 Evalcom2

验证回调函数