华腾永泰OCX读卡器接口

华腾永泰OCX读卡器接口驱动安装程序用于网页的控件，安装后能够启用旅店管理系统的设备。根据屏幕上出现的提示进行安装，安装后需要重启IE浏览器。压缩包内附1.7.2+1.7.4最新版。

第二代身份证接口规范（华腾永泰）

OCX

控件描述：

1

检测设备连接是否正确：

GetState() 

返回值：

数字

’

0

’

-

表示设备正常；

’

<0

’

 -

表示设备错误

, 

对应错误码表

: 

-4: 

未检测到设备

说明：

检测设备连接是否正确，不正确则返回不正确原因。

2

读取二代证信息方法：

ReadCard() 

返回值：

数字

: 

’

0

’

-

表示读卡成功；

’

<0

’

 -

表示读卡失败，

对应错误码表

: 

-4:

未检测到设备

-6:

未检测到卡

说明：

通过网页按钮等事件触发读卡方式。

3

读取二代证信息方法

(

循环读卡

)

：

Start ()

。

返回值：

数字

’

0

’

-

表示读卡成功；

’

<0

’

 -

表示读卡失败，对应错误码表；

说明：

自动读卡方式，用户身份证放在设备上即自动读卡，该接口可选做。

4

属性

Name/NameL 

返回值：

字符串

(BStr)

。

Name 

–

卡片中储存的姓名。

应届生求职季宝典 开启你的职场征途

简历撰写 笔试真题 面试攻略 专业技能指导 公务员专区

NameL 

–

处理过的姓名。

说明：

区别在于

Name

中两个字名称中间有空格，

NameL

则去除了空格。

如：

Name = 

张

三

  NameL = 

张三

5

属性

Sex/SexL 

返回值：

字符串

(BStr)

。

Sex 

–

卡片中储存的性别代码。

SexL 

–

处理过的性别。

说明：

区别在于

Sex

返回国家标准的性别代码，

SexL

则根据

2005

年国家标准翻译出性

别。如：

Sex = 1  SexL = 

男

6

属性

Nation/NationL 

返回值：

字符串

(BStr)

。

Nation 

–

卡片中储存的民族代码。

NationL 

–

处理过的民族。

说明：

区别在于

Nation

返回国家标准的民族代码，

NationL

则根据

2005

年国家标准翻

译出民族。如：

Nation = 01  NationL = 

汉族

7

属性

Born/BornL 

返回值：

字符串

(BStr)

。

Born 

–

卡片中储存的出生日期。

BornL 

–

处理过的出生日期。

说明：

区别在于

Born

返回简化的出生日期，

BornL

则将出生日期格式化

（

YYYYMMDD

）

。

如：

Born = 1967-03-12  BornL = 1967-03-12

8

属性

Address 

返回值：

字符串

(BStr)

。

说明：

身份证中储存的住址。

9

属性

CardNo 

返回值：

字符串

(BStr)

。

说明：

身份证中储存的身份号码。

10

属性

Police 

返回值：

字符串

(BStr)

。

说明：

身份证中储存的签发机关。

11

属性

Activity/

 ActivityL

返回值：

字符串

(BStr)

。

Activity 

–

卡片中储存的有效期限。

ActivityL 

–

处理过的有效期限。

说明：

区别在于

Activity

返回简化的有效期限

，

ActivityL

则将有效期限格式化

。如：

Activity = 1967120119771201

 ActivityL = 1967-12-01-1977-12-01

12

属性

ActivityLFrom 

返回值：

字符串

(BStr)

。

说明：

返回有效期起始时间。如：

ActivityLFrom = 2007-12-01 

13

属性

ActivityLTo 

返回值：

字符串

(BStr)

。

说明：

返回有效期失效时间。如：

ActivityLTo = 2017-12-01

14

属性

PhotoPath 

设置照片存放路径：

字符串（

BStr

）

说明：

缺省不设置

PhotoPath

，

PhotoPath

在缺省或设置为空的情况下，

表示照片不用

保存在客户端设备上。

15

属性

SamId 

返回值：

字符串

(BStr)

。

说明：

返回设备的序列号。如：

SamId

 = 5-1-20060724-128629-3849269270

16

接口

GetPhotoBuffer() 

返回值：

字符串

(BStr) 

说明：

返回照片数据流，具体为

WLT

文件数据流进行

BASE64

编码得到的字符串。

注：

1.

图片大小不能大于

20k

。

2.

控件大小为照片大小获得图像就显示图像，获取失败图像位置显示“照片”

2

字。

3.

照片文件名称（

Str

）要以身份证号命名。

17

身份证图像信息的打印方法：

PrintImage(int nX,int nY) 

返回值：

0 

成功

1 

失败

说明：

提供打印接口，能直接在各种大小的纸张上打印

1:1

的身份证图像；图像信息

包括身份证正反面双面的原始背景、文字、照片等，需尽可能的接近原始效

果。正面图像跟反面图像上下并排。

参数说明：

nX

、

nY 

输入值，单位

mm

，打印的起始坐标，纸张的左上角坐标定位（

0

，

0

）

18

获得照片复印件正反面信息：

GetFaceJpgBase64

（

int iface

）

返回值：

字符串

(BStr) 

说明：

返回照片正反面数据流，具体为

jpg

文件数据流进行

BASE64

编码得到的字符

串。

参数说明：

iface

输入值，

0

双面信息，

1

为正面信息，

2

为反面信息

控件

CAB

包使用方法说明：

1

、用

IdrOcx.cab

的目的：

当客户在访问网站时，在客户端自动下载

IdrOcx.dll

插件。

2

、决方案介绍：

这种自动下载功能，

是

Internet Explorer

的

5.X

以上版本提供的一种基于

Active 

X

的方式。

IE

浏览器会通过网页里面的

<object>

标签所标示的软件名称以及版本，

检测当前系统中是否装有该软件，

若装了，

则检测版本是否比它老，

若当前系统

中没有该软件或者版本不够新时，

IE

就会自动安装该软件，

当然在安装软件之前，

它会有一个安全认证的过程。

（请在浏览器中将该网页设置为受信任的站点，

控

件方可进行安装）

3

、使用方法：

1

）、在网页上发布

IdrOcx.dll

插件。

需要使用的

HTML

元素是：

<object></object>

。

先将我们的操作中涉及的它的

属性介绍如下：

clsid

：生成的类在

windows

中的编号

, 

IdrOcx

控件的

clsid

为

220C3AD1-5E9D-4B06-870F-E34662E2DFEA

。

codebase

：指定需要下载的软件地址及其版本。

具体写法参照

test.html

。比如我们可以在网页中写入：

<OBJECT Name="GT2ICROCX" width="607" height="400" 

CLASSID="CLSID: 220C3AD1-5E9D-4B06-870F-E34662E2DFEA" 

CODEBASE="IdrOcx.cab#version=1,0,1,1"> 

</OBJECT> 

在未安装

ActiveX 

控件的机器上，如果控件

<OBJECT> 

标记中没有指定

CODEBASE

，将不能下载该控件，因而也不能显示。

因此，一定要在控件的

<OBJECT> 

标记中指定

CODEBASE 

属性，并指向正确的控件下载位置。例如

将

test.html

测试页面和

IdrOcx.CAB

发布到服务器同一目录下，

访问

test.html

测试页

面，如果能够正常下载该控件则说明

CODEBASE

设置正确（访问之前先确定完

成如下述步骤的

IE

安全设置）。控件安装完成后，会在

c:\windows\system32

目录

下解开

idrocx.dll,termb.dll,bmp2jpgdll.dll,wltrs.dll

四个文件。

4

、如果客户端使用

USB

端口连接阅读机具，请在客户端安装

USB

驱动。

USB

驱动在控件的安装包或机具配套光盘中有提供，请网站设计者通过在网

页上提供

USB

驱动下载链接或者其他方式为网站访问者提供

USB

驱动。

控件卸载

由于

OCX

只能提供自动安装方式，卸载需要手工进行，为了客户方便，我们

制作了自动卸载的批处理命令。

Uninstallocx.bat 

regsvr32 

–

u c:\windows\system32\idrocx.dll 

del c:\windows\system32\idrocx.dll 

del c:\windows\system32\termb.dll 

del c:\windows\system32\bmp2jpgdll.dll 

del c:\windows\system32\wltrs.dll