ULRegisterForEventW 方法

public ul_bool ULRegisterForEventW(
    SQLCA * sqlca,
    ul_wchar const * event_name,
    ul_wchar const * object_name,
    ul_wchar const * queue_name,
    ul_bool register_not_unreg
)

sqlca 指向 SQLCA 的指针。
event_name 要注册的系统事件或用户定义的事件。
object_name 应用事件的对象（如表名）。
queue_name NULL 表示缺省连接队列。
register_not_unreg true 表示注册，false 表示注销。

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

注意

此方法原型当您在 Win32 平台上引用 ULRegisterForEvent 和 #define the UNICODE 宏时内部使用。通常，您创建 UltraLite 应用程序时不会直接引用此方法。

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

预定义的系统事件为：

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

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

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

ULRegisterForEventW 方法

语法

参数

返回值

注释

注意