此函数允许 Ultralite 用户使用轻量级轮询，来查询 MobiLink 服务器上服务器启动的同步请求的通告程序。

语法

ML_GET_SERVER_NOTIFICATION(notifier, address, key)

参数

返回值

返回给定请求关键字的通知请求的主题和内容。

注释

如果给定的请求关键字没有任何请求，或者 MobiLink 服务器中不存在此通告程序的名称，则结果为 NULL。如果为请求关键字提供的是 NULL，则会将用户的远程 ID 用作请求关键字。如果不存在请求，则采用以下格式返回结果消息：[subject]content（例如，[sync]profile1）。

此函数在检索来自 MobiLink 服务器的响应时，通过网络进行通信。因此，由于需要网络等待，此函数可能需要较长的执行时间。在执行期间，可能存在多个时间段，在这些时间段内，函数可以在后台执行，同时允许在运行时对其它连接执行工作。然而，这些时间段无法得到保证，而且取决于 SQL 的复杂性。对用户而言，在检索要在此函数中使用的 MobiLink 地址时，建议的方法是配合使用 sync_profile_option_value 函数与现有的同步配置文件，以获取 Stream 配置文件选项的值。此函数调用所返回的值可直接用作 MobiLink 地址参数。

另请参见

• SYNC_PROFILE_OPTION_VALUE 函数 [系统]

标准和兼容性

示例

Select ml_get_server_notification('Notifier1', 'tcpip{host=sybase;port=1234}', 'MyKey'