普天身份证阅读器二次开发手册

二次开发SDK说明手册

二代证系统终端控件 使用说明最新09/11/1

上海普天邮通科技股份有限公司

2009年11月

二次开发SDK说明手册

二代证系统终端控件

使用说明

版 本

1.0.3.1

出版日期

2009年11月

著作权注意事项

本书版权为上海普天邮通科技股份有限公司所有。未经上海普天邮通科技股份有限公司书面同意，任何公司、单位或个人，不得用任何手段复制本手册的部分或全部内容。

对印刷错误的更正，所述信息谬误的勘误，以及产品的改进，均由上海邮电通信设备股份有限公司随时作出解释，恕不预先通知，修正内容将编入再版说明书中。

二次开发SDK说明手册

1.前言

本ActiveX控件用于二代证验证系统的验证终端应用系统的开发。

2.系统要求

使用本控件的PC机，必须满足下列条件： Windows 98，Windows 2000, Windows XP 至少32兆内存（32M RAM or Larger）

至少10兆空闲硬盘空间（10M Free Hard Disk Space or Larger） 至少一个空闲普通串口或USB口（视用户需求而定）。

3.文件列表

FirstActivex.ocx ActiveX控件

stdapi.dll 控件依赖的动态联接库 WltRS.dll 控件依赖的动态联接库 license.dat 授权文件

4.注意事项

1．Web开发

一般不要解开cab包，直接将其放在服务器上，以便使用自动安装及自动更新功能。 2．VB开发 将cab包解开，将文件列表中的文件放在一起，注册FirstActivex.ocx，方法是执行

regsvr32 “[Path]FirstActivex.ocx”

打开VB环境，右击工具栏，点击“部件”。在控件列表中找到“FirstActivex Activex Control module”，将其打钩，点“确定”。控件将出现在工具栏中。

5.属性和方法的列表

二次开发SDK说明手册

6.属性和方法的详细说明 属性：

BSTR PhotoPath

设置照片的保存路径，该路径必须存在，如果未设置则不保存照片。

BSTR ActivityLFrom

有效期始，格式：yyyymmdd。

BSTR ActivityLTo

有效期至，格式：yyyymmdd。

long Flag

将此属性置1，禁用重复读卡功能，即卡放在机器上只能读一次。置0打开重复读卡功能，即卡放在机器上可以多次读取。

方法：

long setPortNum(long iPort) 设置端口号。 参数 iPort：端口号，1表示串口1，2表示串口2，1001表示USB1，1002表示USB2，依次类推。0表示自动选择。 返回值 端口号

long ReadCard() 读卡。 参数 无 返回值 返回0x90表示读卡成功，0x01表示端口打开失败，0x02表示接收数据超时，0x41表示读卡失败，其它的错误号表示其它的错误。

BSTR NameL()

二次开发SDK说明手册

获取姓名。 参数 无 返回值

姓名。

BSTR Sex() 获取性别代码。 参数 无 返回值

性别，“1”表示男；“0”表示女。

BSTR SexL() 获取性别。 参数 无 返回值

性别，“男”或“女”。

BSTR Nation() 获取民族代码。 参数 无 返回值

民族代码，例：“01”表示汉。

BSTR NationL() 获取民族。 参数 无 返回值

民族，例：“汉”。

BSTR Born() 获取生日。 参数 无 返回值

生日，格式：yyyymmdd。

BSTR BornL() 获取生日 参数 无 返回值

生日，格式：yyyy年mm月dd日。

BSTR Address() 获取地址 参数 无

二次开发SDK说明手册

返回值

地址。

BSTR CardNo() 获取身份证号码 参数 无 返回值 身份证号码。

BSTR Police() 获取签发机关。 参数 无 返回值

签发机关。

BSTR Activity() 获取有效期限。 参数 无 返回值

有效期限，格式：yyyymmddyyyymmdd。

BSTR ActivityL() 获取有效期限。 参数 无 返回值

有效期限，格式：yyyy.mm.dd-yyyy.mm.dd。

long GetState() 显示阅读器的状态。 参数 无 返回值

上次读卡的错误代码。

7.方法调用说明 7.1方法调用顺序

请首先调用设置端口号方法setPortNum，如果要保存照片，请设置PhotoPath属性，然后调用ReadCard，这时控件将检测端口并读卡。

7.2 照片说明

照片文件命名规则是：(身份证号码).bmp。

二次开发SDK说明手册

7.3 示例代码

Web调用方法参见开发包中的示例网页index.htm。

VB调用方法参见开发包中的VB示例。

本文来源：https://www.bwwdw.com/article/tivq.html