authenticate_parameters 连接事件

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

参数

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

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

SQL 脚本的参数名称	说明	顺序（不建议用于 SQL）
s.authentication_status	INTEGER。这是一个 INOUT 参数。	1
s.remote_id	VARCHAR(128)。MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。	不适用
s.username	VARCHAR(128)。MobiLink 用户名。	2
a.N（一个或多个）	VARCHAR(4000)。例如，已命名的参数可以是 `a.1 a.2`。	3 或更高

参数说明

authentication_status authentication_status 参数是必需的。它指示验证是否完全成功，可设置为以下值之一：

返回值	authentication_status	说明
V <= 1999	1000	验证成功。
1000 <= V <= 2999	2000	验证成功，但口令即将失效。
2000 <= V <= 3999	3000	验证失败，因为口令已失效。
4000 <= V <= 4999	4000	验证失败。
5000 <= V <= 5999	5000	无法验证，因为远程 ID 已在使用中。稍后再尝试同步。
6000 <= V	4000	如果返回值大于 5999，则 MobiLink 将其解释为返回值 4000（验证失败）。

username 此参数为 MobiLink 用户名。VARCHAR(128)。
remote_ID MobiLink 远程 ID。只有在使用命名参数时才能引用远程 ID。
请参见脚本中的远程 ID 和 MobiLink 用户名。
remote a.N 从远程客户端发送来的第 N 个验证参数。

注释

远程参数的数目必须与 authenticate_parameters 脚本要求的数目相匹配，否则会出现错误。如果从客户端发送参数但没有对应于此事件的任何脚本，也将发生错误。

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

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

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

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

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

对于 UltraLite 远程数据库，请使用 ul_sync_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} 
)

使用DocCommentXchange讨论此页。

authenticate_parameters 连接事件

参数

参数说明

注释

另请参见

示例