iAnywhere.com - authenticate_parameters 连接事件

authenticate_parameters 连接事件

功能

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

参数

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

项	参数	说明
1	auth_status	INTEGER。这是一个 INOUT 参数。
2	ml_username	VARCHAR(128)。
3...	remote_parameters（一个或多个）	VARCHAR(128)。

说明

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

对于 UltraLite 远程数据库，请使用 ul_synch_info 结构中的 num_auth_parms 和 auth_parms 字段传递参数。num_auth_parms 是参数的数目（0 至 255），auth_parms 是指向字符串列表的指针。为防止以纯文本格式查看这些字符串，它们与口令采用相同的方式进行发送。如果 num_auth_parms 为 0，请将 auth_parms 设置为 NULL。

下面是在 UltraLite 中传递参数的一个示例：

ul_char * Params[ 3 ] = { UL_TEXT( "parm1" ), UL_TEXT( "parm2" ), UL_TEXT( "parm3" ) };

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

对于 Adaptive Server Anywhere 远程数据库，请使用 dbmlsync -ap 选项，通过逗号分隔的列表传递参数。例如，

dbmlsync -ap "parm1,parm2,parm3"

MobiLink 同步服务器在每个同步开始时执行该事件。该事件与 begin_synchronization 事件在相同的事务中并在 begin_synchronization 事件之前执行。

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

远程参数的数目必须与所需数目相匹配，否则会产生错误。例如，如果发送三个参数，则事件期望的必须是五个参数，因为除这三个参数之外还有 auth_status 和 ml_username。如果从客户端发送参数而没有任何事件，也将发生错误。

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

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

authenticate_parameters 连接事件

功能

参数

说明

另请参见