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++ API 参考 » UltraLite_Connection_iface 类

 

RegisterForEvent 函数

注册或注销(队列)以便接收事件的通知。

语法
bool UltraLite_Connection_iface::RegisterForEvent(
  const ULValue & event_name,
  const ULValue & object_name,
  const ULValue & queue_name,
  bool register_not_unreg
)
参数
  • event_name   要注册的系统事件或用户定义的事件

  • object_name   应用事件的对象(如表名)

  • queue_name   NULL 表示缺省连接队列

  • register_not_unreg   true 表示注册,false 表示注销

返回值

如果注册成功,则返回 true;如果队列或事件不存在,则返回 false。

注释

如果不提供队列名称,则表示采用缺省连接队列,如果需要,可以创建缺省连接队列。某些系统事件允许指定应用事件的对象名称。例如,TableModified 事件可以指定表名称。与SendNotification 函数不同,仅特定的注册队列会收到事件的通知 - 不同连接中同名的其它队列则不会收到通知(除非它们也经过显式注册)。

预定义的系统事件为:

  • TableModified - 插入、更新或删除表中的行时触发。每次请求时发送一个通知,无论多少行受到该请求的影响。object_name 参数指定要监控的表。"*" 值表示数据库中的所有表。此事件拥有名为 "table_name" 的参数,它的值是已修改表的名称。

  • Commit - 任意提交完成后触发。此事件无参数。

  • SyncComplete - 同步完成后触发。此事件无参数。

另请参见