IC卡接口库使用文档

目录1.IC卡接口说明............................................................................................................................................11.1基础数据接口..........................................................................................................................................11.1.1初始化函数..........................................................................................................................11.1.2获取IC卡的卡号................................................................................................................11.1.3获取车辆基本数据函数......................................................................................................11.2扩展数据接口..................................................................................................................................41.2.1读取货运源头治超信息函数..............................................................................................41.2.2写入货运源头治超信息函数..............................................................................................42.IC卡读写错误提示....................................................................................................................................43.IC卡客户端部署........................................................................................................................................4附表一............................................................................................................................................................5附表二............................................................................................................................................................711.IC卡接口说明1.1基础数据接口1.1.1初始化函数【函数功能】初始化中间件。【函数说明】initZhjj(serverIP,serverIP,readerlib,username);参数名参数类型传入/传出说明serverIPstring传入安全中间件服务端地址，UKEY不使用，传入空即可svrportushort传入安全中间件服务端端口，UKEY不使用readerlibstring传入接口库路径字符串usernamestring传入用户名，UKEY固定为“-*UKey*-”返回状态码，具体含义见《附表一》。1.1.2获取IC卡的卡号调用任意读卡函数后，atlDuX.kahao为IC卡的卡号。1.1.3获取车辆基本数据函数【函数功能】读取道路运输电子证件中的车辆基本信息。【函数说明】ReadBasicData()返回状态码，具体含义见《附表一》。调用后，atlDuX.strResult为包含车辆基本数据的xml文件,文件格式为2?xmlversion=1.0encoding=UTF-8?xmlid=ReadVehicleXML!—卡片类型，始发卡、补卡--opercardtype/baseinfo!--此节点是否有数据1：有，0：无--hasdata/!--卡内状态1：始发卡，2：补卡--cardstate/!--经营许可证字--ccertid/!--经营许可证号--ccertword/!--业户地址--owneraddr/!--业户名称--ownername/!--道路运输证字--mcertid/!--道路运输证号--mcertword/!--经营范围--mgrarea/!--营运状态--ccertstat/!--投入营运日期--workdate/!—车辆（挂车）牌照号--vehicleid/!--车牌颜色--vehiclecolor/!--车辆种类--vclkind/!--车辆类型--vcltype/!--核定吨位--checkton/!--核定座位--checkseat/!--计征吨位--ton/!--计征座位--seat/3!--厂牌--mtype/!--型号--mtype1/!--燃料类型--fueltype/!--装备等级--equipgrade/!--发劢机号--engineid/!--车架号--chassisid/!--装备条件--equipcondition/!--长--vcllength/!--宽--vclwidth/!--高--vclheight/!--车身颜色--bodycolor/!--牵引车功率--engpower/!--购车日期--buydate/!—道路运输证发证日期--extenddate/!--行驶证登记日期--regdate/!—发卡人姓名--devname/!--核发日期--checkdate/!--发证机构名称--organname/!--备注--remark//baseinfo/xml41.2扩展数据接口1.2.1读取货运源头治超信息函数【函数功能】读取道路运输电子证件中的货运源头治超信息。【函数说明】readHyzc()返回状态码，具体含义见《附表一》。调用后，atlDuX.strResult为包含货运源头治超信息的字符串，用逗号隔开。其各字段具体含义见附表二。1.2.2写入货运源头治超信息函数【函数功能】向道路运输电子证件写入货运源头治超信息。【函数说明】atlDuX.updateHyzc(alInfo,20)alInfo为写入的治超信息数组，具体含义见附表二，详细使用方法见示例程序中。返回状态码，具体含义见《附表一》。2.IC卡读写错误提示读写卡错误提示JavaScript文件：ICDXInfo.js读写卡错误提示C#文件：ICCardDXInfo.cs3.IC卡客户端部署需要向用户提供对应的安装程序，可根据实际情况进行打包，各文件的部署路径如下：文件名部署路径备注5atlquantum.dllC:\Windows\System32\需要使用regsvr32进行注册Config.xml客户端程序：应用程序所在的目录Web程序：C:\Windows\System32\ICClient.dllC:\Windows\System32\UKICClient.dllC:\Windows\System32\wdhidu1.dllC:\Windows\System32\wdhidu2.dllC:\Windows\System32\附表一状态码说明0读卡器异常，请重试。0x1000数组实际长度与设置的长度不符。功能配置文件相关错误0x1010配置信息获取失败。0x1011无此功能的操作权限。操作成功0x9000接口函数调用成功。操作流程中产生的错误0x9001卡类型不符合。0x9002扩展应用函数传递参数不符合调用标准。0x9003连接中间件失败。0x9004车辆信息有误。安全中间件接口库调用异常错误代码0x9010传入接口的数据不规范。0x9011未按顺序调用接口。0x9012HTTP初始化异常。0x9013获取的服务端数据解析异常。60x9014写卡时对传入的XML数据解析异常。0xF000接口函数调用失败。0xF001接口库版本不一致需更新。安全中间件接口库软件配置相关错误代码0xF010配置文件未找到。0xF011配置文件关键参数配置不全。0xF012本地创建配置文件异常。0xF013本地加载配置文件异常。0xF014本地保存配置文件异常。0xF015公钥配置文件解析异常。0xF016卡片不密钥配置文件解析异常。0xF017当前配置文件中找不到与节点名匹配的卡片文件信息。安全中间件所需动态库支持、硬件相关错误代码0xF020未找到业务办理读写模块的接口库。0xF021未找到发卡业务读写模块的接口库。0xF022未找到证卡打印机的接口库。0xF023动态库卸载异常。0xF024未找到UKEY。0xF025UKEY打开关闭失败。0xF026UKEY认证失败。0xF027UKEY数据读取失败。0xF028读写器打开关闭异常。安全中间件客户端与服务器通讯错误代码0xF030与服务器通讯超时。0xF031客户端认证失败。0xF032客户端安全认证KEY需更新。0xF033在服务器端未找到客户端对应的KEY。0xF034版本一致。70xF035参数解析错误。0xF036客户端注册失败。0xF037服务端没有卡结构配置信息。0xF038XML文件校验失败。0xF039传输报文认证失败。证件卡操作相关错误代码0xF040未找到卡片。0xF041卡片未打开。0xF042卡片内部认证失败。0xF043获取卡片基本信息失败。0xF044卡片被锁定，无法操作。0xF045卡片已被列入黑名单。0xF046数据格式不符合要求。0xF047数据缺少关键信息。0xF048卡片已发过，不能重新发行。0xF049卡片外部认证失败。0xF050卡片不满足操作条件（如认证未通过等）。0xF051卡片不满足发行条件（如非本省卡片等）。0xF052读写器打开关闭异常。0xF053卡片中不存在该文件。0xF054TSAM卡中未找到匹配的密钥。0xF055无此操作权限。附表二序号数据元数据类型长度说明1装载单（运单）编号字符串122货运源头单位字符串5083货物名称字符串304起运时间数字14YYYYMMDDHHNNSS5承运企业(人)字符串106发货单位字符串507收货单位字符串508装货地址字符串509卸货地址字符串5010装载员字符串1011计重员（过磅员）字符串1012开票员字符串1013驾驶员姓名字符串1014驾驶证号字符串1815