描述

 

ProgressHandler方法会导致在长时间调用数据库连接的EXEC，步和GetTable期间定期调用回调函数X.此接口的一个示例使用是在大型查询期间保持GUI更新。

 

PB语法

 

 

参数

 

N

 

[in]在回调X的连续调用之间评估的虚拟机指令数。

 

pCallBack

 

[in]指向回调函数的指针。

 

回调函数原型：

 

FUNCTION sqlite3_progress_handler_callback CDECL (BYVAL pUserData AS DWORD) AS LONG

 

pUserData

 

[in]作为唯一参数传递给回调函数的数据。

 

返回值

 

无返回值。

 

备注

 

每个数据库连接只能同时定义一个进度处理程序;设置一个新的进度处理程序取消旧的进度。将参数pCallBack设置为NULL将禁用进度处理程序。进度处理程序也通过将pCallBack设置为小于1的值来禁用。

 

如果进度回调返回非零，则操作中断。此函数可用于在GUI进度对话框上实现“取消”按钮。

 

进度处理程序回调函数不能执行任何修改调用进程处理程序的数据库连接。请注意，准备和步都会修改其数据库连接，以获取本段中“modify”的含义。