6.6.1 注销
注销流程和登录流程相反,是让用户从服务器注销的过程。注销操作会尝试从您初始化时设置的服务器进行注销。如果您没有调用atrust_initial接口并成功设置服务器地址,那么注销操作不会返回成功。
该流程较为简单,只有一个接口。注意,如果您在一次注销成功后多次重复调用注销接口,那么它们都将返回成功,而不是返回1个成功+后续n个失败。
接口定义
atrust_error_code ATRUST_API atrust_sync_logout();
参数和返回值说明
参数名 | 类型 | 出参/入参 | 必须 | 说明 |
---|---|---|---|---|
返回值 | atrust_error_code | out | aTrust标准错误及回复码 |
示例代码
atrust_error_code ec = atrust_sync_logout();
switch (ec) {
// 成功
case atrust_error_code::OK:
// 注销成功!
break;
case atrust_error_code::ATRUST_CONNECT_ERROR:
// aTrust客户端连接失败!如果重试任然失败,请检查aTrust客户端是否正确安装并运行。
return;
// 未知的业务执行过程失败
default:
// 接口调用失败!请在atrust_code.h中检查错误码,或尝试重试。错误码:ec
return;
}
补充说明 请您不要进行高频率地进行登录、注销操作。aTrust客户端内部的登录和注销流程比较复杂,也需要一定的时间,过于频繁的操作可能导致aTrust客户端出现状态错误。建议的操作间隔在2S以上。
6.5.2 错误码汇总
错误码 | KEY | 描述 |
---|---|---|
0 | OK | 操作成功 |
20002 | ATRUST_CONNECT_ERROR | 本地aTrustAgent服务连接错误,可能没有安装aTrust客户端 |
注意:除了上述错误码处理,你仍需要处理未知错误码场景。