Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » UltraLite - C 及 C++ 编程 » API 参考 » UltraLite C/C++ 公共 API 参考

 

ULRegisterSynchronizationCallback

通过 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;

另请参见