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

SQL Anywhere 11.0.1 (中文) » MobiLink - 服务器管理 » MobiLink 事件 » 同步事件

 

authenticate_parameters 连接事件

接收从远程数据库发送来的值,这些值使您能在用户 ID 和口令之外另外获得一层验证。这些值还可以用于任意地自定义每个同步。

参数

在下表中,说明部分提供 SQL 数据类型。如果您使用 Java 或 .NET 编写脚本,则应该使用相应的数据类型。请参见SQL-Java 数据类型SQL-.NET 数据类型

在 SQL 脚本中,可以使用名称或问号指定事件参数,但不能在一个脚本中混合使用名称和问号。如果使用问号,则参数必须按照如下所示的顺序并且仅当没有指定任何后继参数时才是可选的(例如,如果您想使用参数 2,则必须使用参数 1)。如果使用命名参数,则可以按照任何顺序指定任意参数子集。

SQL 脚本的参数名称 说明 顺序
s.authentication_status INTEGER。这是一个 INOUT 参数。 1
s.remote_id VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。 不适用
s.username VARCHAR(128)。MobiLink 用户名。 2
a.N(一个或多个) VARCHAR(128)。例如,已命名的参数可以是 a.1 a.2 3...
参数说明
  • authentication_status   authentication_status 参数是必需的。它指示验证是否完全成功,可设置为以下值之一:

    返回值 authentication_status 说明
    V <= 1999 1000 验证成功。
    1999 < V <= 2999 2000 验证成功,但口令即将失效。
    2999 < V <= 3999 3000 验证失败,因为口令已失效。
    3999 < V <= 4999 4000 验证失败。
    4999 < V <= 5999 5000 验证失败,因为用户已经在进行同步。
    5999 < V 4000 如果返回值大于 5999,则 MobiLink 将其解释为返回值 4000(验证失败)。

  • username   此参数为 MobiLink 用户名。VARCHAR(128)。

  • remote_ID   MobiLink 远程 ID。只有在使用已命名的参数时才能引用远程 ID。

    请参见在脚本中使用远程 ID 和 MobiLink 用户名

  • remote_parameters   远程参数的数目必须与所需数目相匹配,否则会产生错误。如果从客户端发送参数但没有对应于此事件的任何脚本,也将发生错误。

注释

从 SQL Anywhere 和 UltraLite 客户端都可以发送字符串(或字符串形式的参数)。这使您能在用户 ID 和口令之外另外获得一层验证。这还意味着,您可以在验证过程中根据参数值自定义同步,并在预同步阶段完成此项工作。

MobiLink 服务器在每个同步开始时执行此事件。它与 authenticate_user 事件在同一个事务中执行。

您可以使用此事件并用自定义机制代替内置的 MobiLink 验证机制。您可能希望调用 DBMS 的验证机制,或者实现 MobiLink 的内置机制中没有的功能。

如果调用了 authenticate_user 或 authenticate_user_hashed 脚本且脚本返回一个错误,则不调用此事件。

authenticate_parameters 事件的 SQL 脚本必须作为存储过程实现。

另请参见
示例

对于 UltraLite 远程数据库,请使用 ul_synch_info 结构中的 num_auth_parms 和 auth_parms 字段传递参数。num_auth_parms 是参数数目的计数(0 至 255),auth_parms 是指向字符串数组的指针。为防止以纯文本格式查看这些字符串,它们与口令采用相同的方式进行发送。如果 num_auth_parms 为 0,请将 auth_parms 设置为空。以下是在 UltraLite 中传递参数的一个示例:

ul_char * Params[ 3 ] = { UL_TEXT( "param1" ), 
   UL_TEXT( "param2" ), UL_TEXT( "param3" ) };

...
info.num_auth_parms = 3;
info.auth_parms = Params;

对于 SQL Anywhere 远程数据库,请使用 dbmlsync -ap 选项,通过逗号分隔的列表传递参数。例如,以下命令行传递三个参数:

dbmlsync -ap "param1,param2,param3"

在此示例中,authenticate_parameters 脚本可以为:

CALL my_auth_parm ( 
  {ml s.authentication_status},
  {ml s.remote_id},
  {ml s.username},
  {ml a.1},
  {ml a.2},
  {ml a.3} 
)