智能一卡通管理系统概述.doc

平台SDK开发手册 （CS部分） 平台SDK开发手册 （CS客户端部分） 非常感谢选择本公司产品，我们将竭诚为您提供最好的服务。 本手册内容将不定期更新，恕不另行通知；更新内容将在版本更新信息中给出。 如您对手册中的内容有疑惑或者有好的建议，请通过技术支持联系我们。 我们的进步需要您的宝贵意见。  简介 前提 当您阅读该开发手册时，同时应该拿到以下内容： 1. PlatformSDK.h 2. PlatformSDK.dll及其依赖的其他dll 3. PlatSDK_Test，为平台SDK（CS部分）的测试demo，包括C++源代码及可执行程序。 版本信息 版本号 日期 变更说明 1.0.0 2015-03-23 发布  接口定义 初始化/反初始化接口定义 初始化接口 接口名称： int Plat_Init(); 接口描述： 初始化平台SDK 参数说明： 无 返回值： 成功返回0，错误时返回-1，通过 Plat_GetLastError()查看错误码 备注： 初始化接口只需调用一次，在调用任何接口前，必须调用 Plat_Init完成初始化工作 反初始化接口 接口名称： int Plat_UnInit(); 接口描述： 反初始化平台SDK 参数说明： 无 返回值： 成功返回0，错误时返回-1，通过 Plat_GetLastError()查看错误码 备注： 释放资源，全局只调用一次 用户接口定义 登录接口 接口名称： int Plat_LoginCMS( const char* cscmsIP, int icmsPort, const char* csUserName, const char* csPSW, int iLoginType = 0, int iMqPort = 61618); 接口描述： 用户登录到指定平台 参数说明： 参数名 输入/输出 描述 cscmsIP [in] 中心管理服务器地址，(例“”) icmsPort [in] 中心管理服务器端口。（例80） csUserName [in] 用户名 （例 admin） csPSW [in] 用户密码（例admin） iLoginType [in] 登录类型。（为预留参数，默认为0） iMqPort [in] MQ服务器端口，默认61618 返回值：成功返回一个大于0的会话句柄，错误时返回-1，通过 Plat_GetLastError()查看错误码 备注：无 登出接口 接口名称： int Plat_LogoutCMS(int iUserHandle); 接口描述： 用户登出接口 参数说明： 参数名 输入/输出 描述 iUserHandle [in] Plat_LoginCMS返回的句柄 返回值： 成功返回0，错误时返回-1，通过 Plat_GetLastError()查看错误码 备注： 无 组织资源接口定义 获取控制中心信息接口 接口名称： int Plat_GetAllControlCell( int iUserHandle, int iNeedGetNum, PLAT_CONTROLCELLINFO* pCellBuffer, int* pOutputNum); 接口描述： 获取控制中心列表信息 参数说明： 参数名 输入/输出 描述 iUserHandle [in] Plat_LoginCMS返回的句柄 iNeedGetNum [in] 需要获取的中心个数 pCellBuffer [in][out] 存放控制单元的缓冲区，由调用者分配 pOutputNum [out] 输出资源数目，当缓冲区为NULL时，pOutputNum的值为资源的总的数目，其他情况下pOutputNum为成功输出资源的数目 返回值： 成功返回0，错误时返回-1，通过 Plat_GetLastError()查看错误码 备注： 无 获取区域信息接口 接口名称： int Plat_GetAllRegion ( int iUserHandle, int iNeedGetNum, PLAT_REGIONINFO* pRegionBuffer, int* pOutputNum); 接口描述： 获取区域信息 参数说明： 参数名 输入/输出 描述 iUserHandle [in] Plat_LoginCMS返回的句柄 iNeedGetNum [in] 需要获取的资源个数 pRegionBuffer [in][out] 存放区