MTC 账户接口函数。 更多

宏定义
#define	MTC_PROV_MEDIA_MASK   0xFf
	账户模式掩码
#define	MTC_PROV_SERVICE_MASK   0xFF00

类型定义
typedef enum EN_MTC_PROF_MEDIA_MODE	EN_MTC_PROF_MEDIA_MODE
	账户媒体模式类型。
typedef enum EN_MTC_PROF_SERVICE_MODE	EN_MTC_PROF_SERVICE_MODE
	账户业务模式类型。

枚举
enum	EN_MTC_PROF_MEDIA_MODE {   EN_MTC_PROF_MEDIA_BASE = 0x00,   EN_MTC_PROF_MEDIA_ENHANCE = 0x01 }
	账户媒体模式类型。 更多
enum	EN_MTC_PROF_SERVICE_MODE {   EN_MTC_PROF_SERVICE_VOIP = 0x0000,   EN_MTC_PROF_SERVICE_MMTEL = 0x0100,   EN_MTC_PROF_SERVICE_RCS5 = 0x0200,   EN_MTC_PROF_SERVICE_JOYN_HF = 0x0400,   EN_MTC_PROF_SERVICE_JOYN_BB = 0x0800 }
	账户业务模式类型。 更多

函数
ZFUNC ZINT	Mtc_ProfGetUserSize (ZFUNC_VOID)
	获取账户管理内的用户个数。 更多
ZFUNC ZCHAR *	Mtc_ProfGetUser (ZINT iIndex)
	MTC 账户通过索引获取用户名称。 更多
ZFUNC ZCHAR *	Mtc_ProfGetCurUser (ZFUNC_VOID)
	MTC 账户获取当前用户。 更多
ZFUNC ZINT	Mtc_ProfCreateUser (ZCHAR *pcUserName)
	MTC 账户创建一个用户。 更多
ZFUNC ZINT	Mtc_ProfDeleteUser (ZCHAR *pcUserName)
	MTC 账户删除一个用户。 更多
ZFUNC ZBOOL	Mtc_ProfExistUser (ZCHAR *pcUserName)
	MTC 账户检查存在的用户。 更多
ZFUNC ZINT	Mtc_ProfSaveProvision (ZFUNC_VOID)
	MTC 账户保存当前用户配置。 更多
ZFUNC ZINT	Mtc_ProfResetProvision (ZFUNC_VOID)
	MTC 账户重设当前用户配置。 更多
ZFUNC ZINT	Mtc_ProfRestoreProvision (ZUINT iMode)
	MTC 账户已特定模式恢复当前用户配置。 更多

详细描述

MTC 账户接口函数。

MTC 为多用户环境提供账户管理。每个用户将 拥有自己的配置、联系人和记录信息。他们都保存在 带有用户名称的子目录内。

加载某个用户的账户时，调用 Mtc_CliInit 和 Mtc_CliOpen。加载“账户”目录下Bob的账户时，使用代码：

    //初始化客户端
Mtc_CliInit("账户");
// 初始化回调函数
Mtc_CliCbSetPrint(打印回调);
Mtc_CliCbSetRegOk(注册成功回调);
Mtc_CliCbSetRegFailed(注册失败回调);
... (其他回调)
Mtc_CliOpen("Bob");

也可不适用账户管理。只需使用代码：

//初始化客户端
Mtc_CliInit(账户管理者);
// 初始化回调函数
Mtc_CliCbSetPrint(打印回调);
Mtc_CliCbSetRegOk(注册成功回调);
Mtc_CliCbSetRegFailed(注册失败回调);
... (其他回调)
Mtc_CliOpen(空);

现在配置为默认。它也许无法正常运作。因此在 Mtc_CliStart 前，GUI应该使用 mtc_cli_db.h 等设置配置 "MTC DB Interfaces".

枚举类型说明

enum EN_MTC_PROF_MEDIA_MODE

账户媒体模式类型。

枚举值
EN_MTC_PROF_MEDIA_BASE	媒体库
EN_MTC_PROF_MEDIA_ENHANCE	媒体增加

enum EN_MTC_PROF_SERVICE_MODE

账户业务模式类型。

枚举值
EN_MTC_PROF_SERVICE_VOIP	voip 业务
EN_MTC_PROF_SERVICE_MMTEL	mmtel 业务
EN_MTC_PROF_SERVICE_RCS5	rcs5 业务
EN_MTC_PROF_SERVICE_JOYN_HF	joyn HF 业务
EN_MTC_PROF_SERVICE_JOYN_BB	joyn BB 业务

函数说明

ZFUNC ZINT Mtc_ProfCreateUser (ZCHAR * pcUserName)

MTC 账户创建一个用户。

接口应在 Mtc_CliInit 被调用后再调用。

参数

[in]

pcUserName

新用户名称。

返回值

ZOK	创建新用户成功。
ZFAILED	创建新用户失败。

ZFUNC ZINT Mtc_ProfDeleteUser (ZCHAR * pcUserName)

MTC 账户删除一个用户。

接口需在 Mtc_CliInit 被调用后再调用。

参数

[in]

pcUserName

将被删除的用户名称。

返回值

ZOK	删除用户成功。
ZFAILED	删除用户失败。

ZFUNC ZBOOL Mtc_ProfExistUser (ZCHAR * pcUserName)

MTC 账户检查存在的用户。

接口应在 Mtc_CliInit 被调用后再调用。

参数

[in]

pcUserName

将被检查的用户名称。

返回值

ZTRUE	用户存在。
ZFALSE	用户不存在。

ZFUNC ZCHAR* Mtc_ProfGetCurUser (ZFUNC_VOID )

MTC 账户获取当前用户。

接口应在 Mtc_CliInit 和 Mtc_CliOpen 被调用后再调用。

返回

当前用户字符串，若客户端没有打开，返回 ZNULL。

ZFUNC ZCHAR* Mtc_ProfGetUser (ZINT iIndex)

MTC 账户通过索引获取用户名称。

接口需要在 Mtc_CliInit 被调用后再调用。

参数

[in]

iIndex

账户列表上的索引， 0 到个数 - 1。

返回

用户名称字符串 调用方必须先复制再使用。

ZFUNC ZINT Mtc_ProfGetUserSize (ZFUNC_VOID )

获取账户管理内的用户个数。

接口应在 Mtc_CliInit 被调用后再调用。

返回

账户用户大小。

ZFUNC ZINT Mtc_ProfResetProvision (ZFUNC_VOID )

MTC 账户重设当前用户配置。

接口应在 Mtc_CliInit 和 Mtc_CliOpen 被调用后再调用。

返回值

ZOK	重设供应成功。
ZFAILED	重设供应失败。

ZFUNC ZINT Mtc_ProfRestoreProvision (ZUINT iMode)

MTC 账户已特定模式恢复当前用户配置。

参数

[in]

iMode

EN_MTC_PROF_SERVICE_MODE 和 EN_MTC_PROF_MEDIA_MODE 的整合。

接口应在 Mtc_CliInit 和 Mtc_CliOpen 被调用后再调用。

返回值

ZOK	恢复供应成功。
ZFAILED	恢复供应失败。

ZFUNC ZINT Mtc_ProfSaveProvision (ZFUNC_VOID )

MTC 账户保存当前用户配置。

接口应在 Mtc_CliInit 和 Mtc_CliOpen 被调用后在调用。

返回值

ZOK	保存供应成功。
ZFAILED	保存供应失败。