华腾永泰Ocx接口规范.doc

第二代身份证接口规范（华腾永泰） OCX控件描述： 检测设备连接是否正确：GetState() 返回值： 数字　’0’-表示设备正常；’0’ -表示设备错误, 对应错误码表: -4: 未检测到设备 说明： 检测设备连接是否正确，不正确则返回不正确原因。 读取二代证信息方法：ReadCard() 返回值： 数字:　’0’-表示读卡成功；’0’ -表示读卡失败， 对应错误码表: -4:未检测到设备 -6:未检测到卡 说明： 通过网页按钮等事件触发读卡方式。 读取二代证信息方法(循环读卡)：Start ()。 返回值： 数字　’0’-表示读卡成功；’0’ -表示读卡失败，对应错误码表； 说明： 自动读卡方式，用户身份证放在设备上即自动读卡，该接口可选做。 属性Name/NameL 返回值： 字符串(BStr)。 Name – 卡片中储存的姓名。 NameL – 处理过的姓名。 说明： 区别在于Name中两个字名称中间有空格，NameL则去除了空格。 如：Name = 张 三 NameL = 张三 属性Sex/SexL 返回值： 字符串(BStr)。 Sex – 卡片中储存的性别代码。 SexL – 处理过的性别。 说明： 区别在于Sex返回国家标准的性别代码，SexL则根据2005年国家标准翻译出性别。如：Sex = 1 SexL = 男 属性Nation/NationL 返回值： 字符串(BStr)。 Nation – 卡片中储存的民族代码。 NationL – 处理过的民族。 说明： 区别在于Nation返回国家标准的民族代码，NationL则根据2005年国家标准翻译出民族。如：Nation = 01 NationL = 汉族 属性Born/BornL 返回值： 字符串(BStr)。 Born – 卡片中储存的出生日期。 BornL – 处理过的出生日期。 说明： 区别在于Born返回简化的出生日期，BornL则将出生日期格式化（YYYYMMDD）。如：Born = 1967-03-12 BornL = 1967-03-12 属性Address 返回值： 字符串(BStr)。 说明： 身份证中储存的住址。 属性CardNo 返回值： 字符串(BStr)。 说明： 身份证中储存的身份号码。 属性Police 返回值： 字符串(BStr)。 说明： 身份证中储存的签发机关。 属性Activity/ ActivityL 返回值： 字符串(BStr)。 Activity – 卡片中储存的有效期限。 ActivityL – 处理过的有效期限。 说明： 区别在于Activity返回简化的有效期限，ActivityL则将有效期限格式化。如：Activity = 1967120119771201 ActivityL = 1967-12-01-1977-12-01 属性ActivityLFrom 返回值： 字符串(BStr)。 说明： 返回有效期起始时间。如：ActivityLFrom = 2007-12-01 属性ActivityLTo 返回值： 字符串(BStr)。 说明： 返回有效期失效时间。如：ActivityLTo = 2017-12-01 属性PhotoPath 设置照片存放路径： 字符串（BStr） 说明： 缺省不设置PhotoPath，PhotoPath在缺省或设置为空的情况下，表示照片不用保存在客户端设备上。 属性SamId 返回值： 字符串(BStr)。 说明： 返回设备的序列号。如：SamId = 5-1128629-3849269270 接口GetPhotoBuffer() 返回值： 字符串(BStr) 说明： 返回照片数据流，具体为WLT文件数据流进行BASE64编码得到的字符串。 注：　 图片大小不能大于20k。 控件大小为照片大小获得图像就显示图像，获取失败图像位置显示“照片”2字。 照片文件名称（Str）要以身份证号命名。 身份证图像信息的打印方法：PrintImage(int nX,int nY) 返回值： 0 成功 1 失败 说明： 提供打印接口，能直接在各种大小的纸张上打印1:1的身份证图像；图像信息包括身份证正反面双面的原始背景、文字、照片等，需尽可能的接近原始效果。正面图像跟反面图像上下并排。 参数说明： nX、nY 输入值，单位mm，打印的起始坐标，纸张的左上角坐标定位（0，0） 获得照片复印件正反面信息：GetFaceJpgBase64（int iface） 返回值： 字符串(BStr) 说明： 返回照片正反面数据流，具体为jpg文件数据流进行BASE64编码得到的字符串。 参数说明： ifa