/********************************************************************* *文件说明: 用户管理模块 *作者: logos *日期: 2014/01/22 *修改日志: 2014/01/22 logos create ***********************************************************************/ #pragma once #ifndef DLL_INCLUDE_LOGIN_H #define DLL_INCLUDE_LOGIN_H #ifndef WINAPI #define WINAPI __stdcall #endif #ifndef EXPORT_C #define EXPORT_C extern "C" #endif #ifndef MAX_NAME_LEN #define MAX_NAME_LEN 32 #endif #ifndef MAX_PWD_LEN #define MAX_PWD_LEN 16 #endif #define MAX_LIMIT_CNT 32 //权限项最大值 enum EMUserGroup {//用户等级 EUser_Level0 = 0, //未登录 EUser_Level1, //OP EUser_Level2, //admin EUser_Level3, //system EUser_Level4, //root }; struct TUser {//用户信息 char name[MAX_NAME_LEN]; //用户名 unsigned int group; //组别 unsigned int limit; //权限 -- 位 }; struct TUserLimit {//用户权限 char name[MAX_NAME_LEN]; //名称 char desc[MAX_NAME_LEN]; //标题 }; enum EM_ERR_USER {//错误代码 ERR_NO_LOGIN = -1100, //未登录 ERR_NO_LIMIT, //无权限 ERR_USER_EXIST, //用户已存在 ERR_USER_TOO_LONG, //用户名过长 ERR_PWD_TOO_LONG, //密码过长 ERR_INVALID_USER, //用户名无效 ERR_INVALID_PWD, //密码无效 ERR_INVALID_LIMIT, //无效的权限项 ERR_REPEAT_LIMIT, //重复的权限项 ERR_LIMIT_OVER, //权限设置超限 }; /**************************************************** *Function: 初始化模块 *Intput: NULL *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI user_init(); /**************************************************** *Function: 释放模块 资源 *Intput: NULL *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI user_deinit(); /**************************************************** *Function: 用户登陆,成功后调用get_cur_limit获取权限 *Intput: lpUser 用户名 lpPwd 密码 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI login(const char* lpUser, const char* lpPwd); /**************************************************** *Function: 用户退出登陆 *Intput: NULL *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI logout(); /**************************************************** *Function: 修改用户信息, 权限足够才能调用 *Intput: lpOldUser 要修改的用户名 lpNewUser 新的用户名 默认值不修改 group 新的组别 admin/system 默认值不修改 limit 新的权限 默认值不修改 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI change_user(const char* lpOldUser, const char* lpNewUser = 0, unsigned int group = 0, unsigned int limit = 0); /**************************************************** *Function: 修改用户密码 *Intput: lpUser 用户名 lpOldPwd 旧密码 lpNewPwd 新密码 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI change_pwd(const char* lpUser, const char* lpOldPwd, const char* lpNewPwd); /**************************************************** *Function: 清空密码, 权限足够才能调用 *Intput: lpUser 用户名 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI clear_pwd(const char* lpUser); /**************************************************** *Function: 增加一个用户 *Intput: lpUser 用户名 lpPwd 密码 group 组别 admin/system limit 权限 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI add_user(const char* lpUser, const char* lpPwd, unsigned int group, unsigned int limit); /**************************************************** *Function: 删除一个用户 *Intput: lpUser 用户名 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI del_user(const char* lpUser); /**************************************************** *Function: 获取用户列表 *Intput: pstUser 用户缓冲区，可以传NULL获取数量 *Output: pstUser 用户缓冲区 *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI get_user_list(TUser* pstUser = 0); /**************************************************** *Function: 获取当前用户名 *Intput: NULL *Output: NULL *Return: 返回当前用户名,失败返回NULL ******************************************************/ EXPORT_C const char* WINAPI get_cur_user(); /**************************************************** *Function: 获取当前用户名 *Intput: NULL *Output: pname 从这里返回名称 *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI get_cur_users(char* pname); /**************************************************** *Function: 获取用户组别 *Intput: pszuser 用户名 传入空标识当前用户 *Output: NULL *Return: 返回当前用户的组别 ******************************************************/ EXPORT_C unsigned int WINAPI get_user_group(const char* pszuser = 0); /**************************************************** *Function: 获取用户权限 *Intput: pszuser 用户名 传入空标识当前用户 *Output: NULL *Return: 返回当前用户的权限 ******************************************************/ EXPORT_C unsigned int WINAPI get_user_limit(const char* pszuser = 0); /**************************************************** *Function: 判断当前用户是否有某项权限 *Intput: pszname 权限项名称 pszuser 用户名 传入空标识当前用户 *Output: NULL *Return: 返回1标识有，0标识没有 ******************************************************/ EXPORT_C int WINAPI chk_user_limit(const char* pszname, const char* pszuser = 0); /**************************************************** *Function: 增加一项权限,最多支持32项权限 *Intput: index 索引，区间[0,32) pszname 名称，不能重复 pszdesc 描述标题，显示在界面上的，若为空则显示名称 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 *PS: 在需要检测权限的代码中使用chk_user_limit函数, 可根据权限名判断当前用户是否有该项权限 ******************************************************/ EXPORT_C int WINAPI add_limit(const char* pszname, const char* pszdesc = 0); /**************************************************** *Function: 删除其中一项权限 *Intput: index 自定义权限索引 *Output: NULL *Return: 成功返回0, 失败返回错误码<0 *PS: 必须保留最少一个权限项 ******************************************************/ EXPORT_C int WINAPI del_limit(int index); /**************************************************** *Function: 获取权限项列表 *Intput: pstlimit 权限项数组，可以传NULL *Output: pstlimit 权限项数组 *Return: 成功权限项数量, 失败返回错误码<0 *PS: 先传NULL获取数组大小，new申请内存传入指针获取列表 ******************************************************/ EXPORT_C int WINAPI get_limit_list(TUserLimit* pstlimit = 0); /**************************************************** *Function: 获取权限项描述-也可判断某权限项是否存在 *Intput: pszname 权限名称 pszdesc 权限描述，可以传NULL *Output: NULL *Return: 成功返回0, 失败返回错误码<0 ******************************************************/ EXPORT_C int WINAPI get_limit_info(const char* pszname, char* pszdesc = 0); #endif //防止重复包含