通过 SQL SYNCHRONIZE 语句执行同步时,注册一个要调用的函数。如果使用 UltraLite 定义和注册同步回调函数,则无论何时执行 SYNCHRONIZE 语句,都会将该同步的进度信息传递给回调函数。如果未注册任何回调,则将取消进度信息。
void ULRegisterSynchronizationCallback ( SQLCA * sqlca, ul_synch_observer_fncallback, ul_void * user_data );
sqlca 指向 SQL 通信区的指针。
在 C++ API 中使用 Sqlca.GetCA 方法。
callback 回调函数的名称。
回调值 UL_NULL 禁用任何以前注册的回调函数。
user_data 全局变量的一个替代,使任何上下文信息在全局范围内均可访问。这是必需的,因为您可以从应用程序中的任何位置调用回调函数。UltraLite 不修改提供的数据,它只是在回调函数被调用时将这些数据传递给回调函数。
您可以声明任何数据类型,然后在回调函数中将其转换为正确的类型。例如,可以在回调函数中添加一行以下形式的代码:
MyContextType * context = (MyContextType *) user_data; |
Copyright © 2009, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.1 |