电力监控组态软件权限管理接口说明书6.docx

NTS-9000能源管理系统平台软件V1.20权限管理接口说明书

模块功能概述：

模块功能概述：

权限管理模块具有两大功能：用户权限的限定和管理范围的界定。用户权限的限定是指限定用户可以执行哪些程序或调用哪些服务；管理范围的界定则是指界定用户在允许运行的程序或允许调用的服务中可以获得哪些信息。

权限管理模块支持Unicode字符集，Debug版名称为NTS_LoginUD.Dll，Release版名称为NTS_LoginU.Dll。该模块存放于NTS-9000系统根目录下。

模块调用方式：

权限管理模块提供6个调用接口，分别是用户登录接口、用户注册接口、检查图形文件接口、获得图形文件接口、检查厂站信息接口和获得厂站信息接口。

用户首先调用登录接口，成功后再调用注册接口。注册成功后，就可以调用检查图形文件接口、获得图形文件接口、检查厂站信息接口和获得厂站信息接口以获得相应的服务。

接口说明：

用户登录接口：

用户登录接口的功能是检查用户是否具有运行指定程序或调用指定服务的权限。接口具体定义如下：

externC_declspec(dllexport)BOOLWdCheckPswd(HANDLEhPipe,DWORDdwRight,constCStringstrModuleName,CStringstrUserName,intiUserID,CStringpErrorText);

//参数：

//hPipe：服务器管道

//dwRight：模块操作权限

//strModuleName：模块名称

//strUserName：返回用户名称

//iUserID：返回的用户ID

//pErrorText：返回的错误信息

//返回值：TRUE：通过FALSE：失败

用户注册接口：

用户注册接口负责导入指定用户的管理范围的配置信息。具体定义如下：

externC_declspec(dllexport)BOOLWdRegistUser(HANDLEhPipe,intiUserID,CStringpErrorText);

//参数：

//hPipe：服务器管道

//iUserID：用户ID

//pErrorText：返回的错误信息

//返回值：TRUE：成功FALSE：失败

检查图形文件接口：

检查图形文件接口的功能是检查用户是否可以浏览指定图形文件。具体定义如下：

externC_declspec(dllexport)BOOLWdCheckPic(HANDLEhPipe,CStringsPicName,intiUserID,CStringpErrorText);

//参数：

//hPipe：服务器管道

//sPicName：图形文件名称

//iUserID：用户ID

//pErrorText：返回的错误信息

//返回值：TRUE：用户拥有浏览权限FALSE：失败

获得图形文件接口：

获得图形文件接口的功能是获得指定用户配置的所有图形文件的信息。具体定义如下：

externC_declspec(dllexport)BOOLWdGetUserPics(HANDLEhPipe,intiUserID,BOOLbALLFlag,intPicCount,BYTE**ppPicName,CStringpErrorText);

//参数：

//hPipe：服务器管道

//iUserID：用户ID

//bALLFlag：返回用户是否具有全部图形的浏览权限。TRUE：具有浏览全部图形文件的权限；FALSE：不具有浏览全部图形文件的权限。

//PicCount：返回的图形文件名称数目

//ppPicName：图形文件名称数组

//pErrorText：返回的错误信息

//返回值：TRUE：成功FALSE：失败

注意：ppPicName在接口内部使用new方法分配内存空间，由调用者使用delete方法进行释放；ppPicName为图形文件信息结构体的二进制流，图形文件信息结构体定义如下：

typedefstruct

{

TCHARPicName[129];//图形文件名称（带文件后缀名）

}STRUCT_PICNAME;

检查厂站信息接口：

检查厂站信息接口的功能是检查用户是否可以浏览指定厂站的数据。具体定义如下：

externC_declspec(dllexport)BOOLWdCheckStation(HANDLEhPipe,WORDwProjectID,WORDwStationID,intiUserID,CStringpErrorText);

//参数：

//hPipe：服务器管道

//wProjectID：工程号

//