LPEVALCOMCALLBACK 回调函数 (evalcom2.h)

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

语法

LPEVALCOMCALLBACK Lpevalcomcallback;

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

参数

[in] iStatus

指定 evalcom2 发送的状态消息。

含义
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

包含适合状态的信息的字符串值。 如果 iStatusieStatusICECount,则 szwData 的值应为正在运行的 ICE 数。 如果 iStatusieStatusRunICE,则 szwData 的值应为正在运行的 ICE 的名称。 否则, szwData 的值应为 NULL。 回调函数应接受 NULL 作为此参数的可能值。

pContext

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

返回值

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

注解

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

要求

要求
最低受支持的客户端 Evalcom2.dll 版本 3.0.3790.371 或更高版本
目标平台 Windows
标头 evalcom2.h

另请参阅

IValidate

使用 Evalcom2

验证回调函数