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

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

一、模块功能概述：

1、模块功能概述：

权限管理模块具有两大功能：用户权限的限定和管理范围的界定。用户权限的

限定是指限定用户可以执行哪些程序或调用哪些服务；管理范围的界定则是指界定

用户在允许运行的程序或允许调用的服务中可以获得哪些信息。

权限管理模块支持Unicode字符集，Debug版名称为NTS_LoginUD.Dll，Release

版名称为NTS_LoginU.Dll。该模块存放于NTS-9000系统根目录下。

2、模块调用方式：

权限管理模块提供6个调用接口，分别是用户登录接口、用户注册接口、检查

图形文件接口、获得图形文件接口、检查厂站信息接口和获得厂站信息接口。

用户首先调用登录接口，成功后再调用注册接口。注册成功后，就可以调用检

查图形文件接口、获得图形文件接口、检查厂站信息接口和获得厂站信息接口以获

得相应的服务。

二、接口说明：

1、用户登录接口：

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

口具体定义如下：

externC_declspec(dllexport)BOOLWdCheckPswd(HANDLEhPipe,DWORDdwRight,const

CStringstrModuleName,CStringstrUserName,intiUserID,CStringpErrorText);

//参数：

//hPipe：服务器管道

//dwRight：模块操作权限

//strModuleName：模块名称

//strUserName：返回用户名称

//iUserID：返回的用户ID

//pErrorText：返回的错误信息

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

2、用户注册接口：

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

externC_declspec(dllexport)BOOLWdRegistUser(HANDLEhPipe,intiUserID,CString

pErrorText);

//参数：

//hPipe：服务器管道

//iUserID：用户ID

//pErrorText：返回的错误信息

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

3、检查图形文件接口：

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

externC_declspec(dllexport)BOOLWdCheckPic(HANDLEhPipe,CStringsPicName,int

iUserID,CStringpErrorText);

//参数：

//hPipe：服务器管道

//sPicName：图形文件名称

//iUserID：用户ID

//pErrorText：返回的错误信息

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

4、获得图形文件接口：

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

下：

externC_declspec(dllexport)BOOLWdGetUserPics(HANDLEhPipe,intiUserID,BOOL

bALLFlag,intPicCount,BYTE**ppPicName,CStringpErrorText);

//参数：

//hPipe：服务器管道

//iUserID：用户ID

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

FALSE：不具有浏览全部图形文件的权限。

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