昆仑通态用户权限函数

发布时间:2020-11-14

用户权限函数

此版本支持的用户登录操作函数有:

Ø  !ChangePassword()

Ø  !CheckUserGroup(strUserGroup)

Ø  !Editusers()

Ø  !EnableExitLogon(n)

Ø  !GetCurrentGroup()

Ø  !GetCurrentUser()

Ø  !LogOff()

Ø  !LogOn()

Ø  !SilentLogOn(strName, strPassword, method,  time)

Ø  !SilentLogOff()

Ø  !SilentChangePassword(strName,  strNewPassword)

Ø  !LogOnByUSB()

Ø  !ExportUserToUSB()

Ø  !ImportUserByUSB(importFlag)

!ChangePassword()

函数意义: 弹出改变密码窗口,供当前登录的用户修改密码

返 回 值: 浮点数
=  0,任何情况下,均返回0

参     数: 无

实     例: !ChangePassword()

注意事项: 在弹出的密码修改窗口保存修改密码时如果当前用户已经注销,则需要重新登录*

!CheckUserGroup(strUserGroup)

函数意义: 检查当前登录的用户是否属于strUserGroup用户组的成员

返 回 值: 浮点数
=  0,当前用户属于该组
=  1,当前用户不属于该组

参     数: 无

实     例: ret = !CheckUserGroup("管理员组")

!Editusers()

函数意义: 弹出用户管理窗口,供有子用户组的操作者配置用户

返 回 值: 浮点数
=  0,任何情况下,均返回0

实     例: !Editusers()

注意事项: (1)登录用户为负责人(级管理员)或该用户隶属的用户组存在子组,才能看到用户管理窗口
(2)当前登录用户被注销,用户管理窗口内保存修改需要重新登录*

!EnableExitLogon(n)

函数意义: 打开/关闭退出时的权限检查

返 回 值: 浮点数,任何情况下,都代表执行*

参     数: n,浮点数
n = 0,代表退出时不进行权限检查
n =  1,代表退出时进行权限检查
n =  2,代表当前登录用户过登录时长设置自动注销时,弹出用户注销提示框
n =  3,代表当前登录时注销时,直接静默执行注销,无任何弹窗(未设置默认为此种行为)

实     例: !EnableExitLogon(1),退出时进行权限检查!EnableExitLogon(2),登录用户过登录时长时,用户注销进行提示,选择否或关闭,重新开始计时

!GetCurrentGroup()

函数意义: 读取当前登录用户的所在用户组名

返 回 值: 字符串,当前登录用户组名,多个用户组时,组名之间以不可见ASCII字符0x01分隔。如没有登录返回空。

参     数: 无

实     例: ret = !GetCurrentGroup()

注意事项: 如果同时存在多个用户组,用户组之间以不可见ASCII字符0x01分隔

!GetCurrentUser()

函数意义: 读取当前登录用户的用户名

返 回 值: 字符串,当前登录用户的用户名,如没有登录返回空

参     数: 无

实     例: ret = !GetCurrentUser()

!LogOff()

函数意义: 注销当前用户

返 回 值: 浮点数
=  0,注销当前用户*
=  其他,注销当前用户失败

参     数: 无

实     例: !LogOff()

!LogOn()

函数意义: 弹出登录对话框

返 回 值: 浮点数
= 0,登录用户操作*
= 其他,登录用户操作失败

参     数:无

实     例:!LogOn()

注意事项: (1)如果已有登录用户,再次登录其他用户*,才会将已有登录用户登出
(2)如果已有登录用户,再次弹出登录窗口,默认选择已登录用户,如果无登录用户,默认选择负责人用户
(3)修改选中用户的登录时长,登录*后才会保存。否则不保存登录时长设置

!SilentLogOn(strName,  strPassword, method, time)

函数意义: 静默登录,不弹出用户登录对话框

返 回 值: 整数
= 0,登录用户操作*
其他,登录用户操作失败,见第十章脚本函数返回值参考

参     数: strName:字符串,要登录的用户名称
strPassword:字符串,要登录的用户密码
method:注销方式。0:登录时,用户保持登录状态过设定时间后注销;1:自动注销,当触摸屏无人操作的持续时间过设定时间后注销。
time:时时间,单位分钟。为0时表示*。与注销方式配合使用。

实     例: !SilentLogOn(name, password, 0, 0):登录名为“name”的用户,注销方式为登录时,登录时间为*。

注意事项: 如果已有登录用户,本次登录用户*,会直接将已登录用户登出

!SilentLogOff()

函数意义: 静默注销,不弹出注销确认对话框

返 回 值: 无。

参     数: 无。

实     例: !SilentLogOff()

!SilentChangePassword(strName, strNewPassword)

函数意义: 静默修改用户密码,不弹出修改密码对话框

返 回 值: 整数
=  0,修改密码操作*
其他,修改密码操作失败,见第十章脚本函数返回值参考

参     数: strName:字符串,要改密的用户名称
strPassword:字符串,要更改的新密码

实     例: !SilentChangePassword(name, newpassword)

注意事项: 修改密码的权限范围遵循运行环境的权限管理方式。

!LogOnByUSB()

函数意义: 使用USB密钥登录

返 回 值: 整数
=   0,登录用户操作*
其他,登录用户操作失败,见第十章脚本函数返回值参考

参     数: 无。

实     例: !LogOnByUSB()

!ExportUserToUSB()

函数意义: 将运行环境的用户信息导出至USB存储设备

返 回 值: 整数
= 0,导出操作*
其他,导出操作失败

参     数: 无。

实     例:  !ExportUserToUSB()

!ImportUserByUSB(ImportFlag)

函数意义: 从USB存储导入用户信息

返 回 值: 整数
= 0,导入操作*
其他,导入操作失败

参     数: 无。ImportFlag:导入方式。0:追加导入;1:覆盖导入

实     例:  !ImportUserByUSB(0)

注意事项:(1)追加导入时,如果运行环境已有同名用户存在则导入失败
(2)追加导入时,如果组态环境和运行环境的用户组信息不一致则可能导入失败
(3)覆盖导入时,级用户无法覆盖,仍保留原运行环境的级用户信息

 


上一篇:宝鸡渭滨仪器设备-量具外校-...
下一篇:路基分裂机设备快