OCX接口说明3.3.4.doc

概述 精伦电子股份有限公司开发的二代身份证读卡系列机具适用于相关行业的联机型应用。产品提供了完善的二次软件开发接口（API）。本手册针对提供的ActiveX控件，对开发接口的文件组成、函数定义格式、调用方法及返回值等进行了详细的说明。 接口文件说明 接口文件包括： IdrControl.ocx Dewlt.dll Savephoto.dll 适用开发语言： 网络脚本开发 接口函数说明 身份证函数 读身份证函数 原 型：short ReadCard(long iPort,BSTR PhotoPath) 说 明：本函数用于打开串口或USB口并读取二代证卡内信息。 参 数： 1、iPort： 设置串口、USB或iDR210免驱动 USB-HID。 普通串口 1 – 16(十进制) 例如： 1：串口1(COM1) 2：串口2(COM2) USB USB-HID (iDR210) 1001 例如： 1001：USB 2、PhotoPath：生成图片文件的绝对路径，包括生成的照片文件photo.bmp,photo.jpg和指定文件名的照片文件，和身份证正反面图片card.jpg。该参数为时，默认将照片文件保存到Windows系统临时文件目录(GetTempPath())。也可自行设置保存的路径，比如： d:\\photos\\photo.bmp，注意文件参数必须设置正确，才能正确地将相片文件放在指定位置(相片文件夹若不存在，将会自动生成新文件夹)。 返 回 值： 值 说明 1 正确 -1 端口初始化失败 -2 卡认证失败（请重新将卡放到读卡器） -3 读取数据失败 -4 生成照片文件失败（请检查设定路径和磁盘空间） 注：如果读卡机具连接的端口是确定的，可以直接使用相应端口号调用本函数。否则，可以采用循环查找的方式调用本函数。 端口初始化函数 原 型：short InitComm(long iPort) 说 明：本函数用于打开串口或USB并检测读卡设备是否就绪。 参 数：iPort： 设置串口或USB（目前串口和USB都只支持16个，即串口1～16和USB1001-1016） 普通串口 1 – 16(十进制) 例如： 1：串口1(COM1) 2：串口2(COM2) USB USB-HID (iDR210) 1001 例如： 1001：USB 返 回 值： 值 意义 1 正确 其它 错误 注：如果读卡机具连接的端口是确定的，可以直接使用相应端口号调用本函数。否则，可以采用循环查找的方式调用本函数。 端口关闭接口 原 型：int CloseComm(void) 说 明：本函数用于关闭已打开的端口，一般在调用InitComm成功并完成读卡任务后调用。 参 数：无 返 回 值： 值 意义 1 正确 其它 错误 卡认证接口 原 型：short Authenticate (void) 说 明：本函数用于发现身份证卡并选择卡。 参 数：无 返 回 值： 值 意义 1 正确 0 错误 注：认证卡时，需要将身份证放置于读卡机具上方并做稍许时间的停留。如果函数返回错误表示没有发现卡或者卡停留时间太短。 获得身份证信息个人姓名 原 型：BSTR GetName()； 说 明：本函数用于获取身份证个人姓名信息。 返 回 值：个人姓名信息 注：必须在ReadCard函数调用并返回正确的情况下方能正确获得身份证个人姓名信息 获得身份证个人性别信息（汉字） 原 型：BSTR GetSex()； 说 明：本函数用于获取身份证个人性别信息。 返 回 值：个人性别信息，男或女。 注：必须在ReadCard函数调用并返回正确的情况下方能正确获得身份证个人性别信息 获得身份证个人性别信息（数字） 原 型：short GetSexN()； 说 明：本函数用于获取身份证个人性别代码。 返 回 值： 值 说明 1 男 2 女 注：必须在ReadCard函数调用并返回正确的情况下方能正确获得身份证个人性别信息 获得身份证信息个人民族（汉字） 原 型：BSTR GetFolk()； 说 明：本函数用于获取身份证个人民族信息。 返 回 值：个人民族信息 注：必须在ReadCard函数调用并调用并返回正确的情况下方能正确获得身份证个人民族信息 获得身份证信息个人民族（数字） 原 型：Short GetFolkN()； 说 明：本函数用于获取身份证个人民族数字代码。 返 回 值：个人民族信息数字代码 返回值以代码表示，下列是民族编码顺序，汉族编码为1，蒙古为2