（精选文档）OCX控件二次开发手册指南

1、二次开发说明序：在调用OCX控件之前需要注册OCX控件，在dos里输入regsvr32 pathxxx.ocx可以实现OCX控件的注册，输入regsvr32 /u pathxxx.ocx可以注销已经注册的OCX控件。如：注册IdCardFingerCom.dll控件，regsvr32 C:Documents and Settings IdCardFingerCom.dll。IdCardFingerCom.dll控件的classid：1ABD01EC-2767-464B-93EE-12DA867464FA。需把2个动态库WltRS.dll、SynoAPIEx_CR20.dll和控件IdCardF

2、ingerCom.dll连同文件夹IdCardFingerCom整体放到C盘根目录下(这步很重要，须严格按照要求来做)。如果需要通过IdCardFingerCom.dll控件操作android设备，则需要在android设备中安装来打开/关闭android设备下位机的电源(如：A320A和A370)。为需要用到的dll和ocx控件压缩包。经过测试IdCardFingerCom.dll控件支持javascript(目前仅支持IE浏览器)、c#、vb语言调用。为javascript、c#、vb语言调用控件的演示程序。一、 设备获取、打开说明1. HRESULTPSGetUDiskNum(inint

3、deviceFlag,out,retvalint*deviceNum);功能说明：获取UDISK设备数，即获取CR20/CR30/CR30A/A320A/A370的设备数。参数说明：参数deviceFlag为入参，值为1时表示获取CR30/CR30A/A320A/A370设备数，值不为1时表示获取CR20设备数。返回值说明：参数deviceNum为返回值，表示获取到的设备数目，小于等于0说明未获取到设备数2. HRESULTPSOpenDeviceEx(inintdeviceFlag);功能说明：打开CR20/CR30/CR30A/A320A/A370设备USB接口。参数说明：参数device

4、Flag为入参，值为1时表示打开CR30/CR30A/A320A/A370设备，值不为1时表示打开CR20设备。返回值说明：无。可以通过(六)中的属性Result的值来判断为0表示打开成功，否则打开失败。3. HRESULTPSCloseDeviceEx();功能说明：关闭CR20/CR30/CR30A/A320A/A370设备USB接口。参数说明：无。 返回值说明：无。可以通过(六)中的属性Result的值来判断为0表示打开成功，否则打开失败。二、 指纹注册功能流程图三、 指纹验证流程图1.一对一比对流程图：2.一对多比对流程图：四、 指纹功能方法说明1. HRESULTPSGetImage

5、();功能说明：检测手指，检测到后录入指纹图像存于ImageBuffer。参数说明：无。返回值说明：无2. HRESULTPSUpImage(out,retvalBSTR*imageData);功能说明：将图像缓冲区中的原始指纹图像数据上传给上位机。参数说明：无返回值说明：参数imageData为返回值，表示原始指纹图像数据 注：调用此函数以后，可以通过HRESULTImageLength(out,retvallong*pVal);属性值获取指纹图像数据的长度。3. HRESULTPSImgData2BMP(inBSTRimageFile,inBSTR*imageData);功能说明：将原始的

6、指纹图像数据转换为可视的指纹图像参数说明： imageFile入参为转换以后的指纹图像路径+图片名，imageData入参为原始指纹图像数据。返回值说明：无4. HRESULTPSGenChar(inintbufferId);功能说明：将ImageBuffer中的原始指纹图像数据生成指纹特征文件存于CharBuffer1或者CharBuffer2中。参数说明：参数bufferId为入参， bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)返回值说明：无注：本文中的h表示十六进制5. HRESULTPSRegModule();功能说明：将CharBuffer1

7、 与CharBuffer2 中的特征文件合并生成模板，结果存于CharBuffer1 与CharBuffer2。参数说明：无返回值说明：无6. HRESULTPSUpChar(inintbufferId,out,retvalBSTR*templetData);功能说明：将特征缓冲区中的特征文件上传给上位机参数说明：参数bufferId为入参，bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)。返回值说明：templetData为返回值，表示上位机将要接收的指纹特征模板数据注：调用此函数以后，可以通过HRESULTTempletLength(out,retva

8、llong*pVal);属性值获取指纹特征模板数据的长度。7. HRESULTPSDownChar(inintbufferId,in BSTR *templetData);功能说明：上位机下载特征文件到模块的一个特征缓冲区参数说明：参数bufferId为入参， bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)，templetData入参为下位机将要接收的指纹特征模板数据。返回值说明：无8. HRESULTPSMatch(out,retvalint*score);功能说明：精确比对CharBuffer1和CharBuffer2中的特征文件参数说明：无。返回值

9、说明：score 为返回值，表示指纹比对得分9. HRESULTPSStoreChar(inintbufferId,inintpageId);功能说明：将CharBuffer1或者CharBuffer2中的模板文件存到pageId号flash数据库位置参数说明：参数bufferId和pageId为入参， bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)，pageId为要存入flash库的位置(该值为01023之间的数)返回值说明：无10.HRESULTPSSearch(inintbufferId,inintstartPage,inintpageNum,ou

10、t,retvalint*score);功能说明：以CharBuffer1或者CharBuffer2中的特征文件搜索整个或部分指纹库，若搜索到则返回页码。参数说明：参数bufferId、startPage和pageNum为入参, bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)，startPage为搜索起始页，pageNum为搜索页数(startPage为01023之间的数，iPageNum应小于等于1023 - startPage)。返回值说明：score为返回值，表示搜索指纹得分(搜索到的指纹和bufferID中的指纹特征值相似度越高，则得分越高)。注：

11、调用此函数以后，可以通过HRESULTMbAddress(out,retvallong*pVal);获取搜索到的与当前指纹匹配的指纹模板在指纹flash库中的位置11. HRESULTPSEmpty();功能说明：清空指纹flash库参数说明：无返回值说明：无五、 身份证信息的获取1.HRESULTPSUpIDCardData(inBSTRzpFile,out,retvalBSTR*idCardData); 功能说明： 获取身份证信息，解析身份证文本信息和照片信息，生成照片bmp文件，调用此函数以后可以通过以下的210的属性值获取身份证的姓名、性别、民族、生日、住址、身份证号码、签证机关、生效

12、日期和失效日期，并且可以在zpFile所设置的路径+文件名下获取到和zpFile相同文件名但不同扩展名的照片文件(如：zpFile为zp.wlt，则照片文件为zp.bmp)参数说明：zpFile为希望身份证照片生成路径+文件名，文件必须以.wlt为扩展名，如:D:zp.wlt 返回值说明：idCardData为返回值，表示原始的身份证数据2.HRESULTCardName(out,retvalBSTR*pVal);姓名 3.HRESULTCardSex(out,retvalBSTR*pVal);性别4.HRESULTCardRace(out,retvalBSTR*pVal);民族 5.HRES

13、ULTCardBirth(out,retvalBSTR*pVal);生日 6.HRESULTCardAddress(out,retvalBSTR*pVal);住址 7.HRESULTCardIdNum(out,retvalBSTR*pVal);身份证号码 8.HRESULTCardIssue(out,retvalBSTR*pVal);签证机关 9.HRESULTCardStartTime(out,retvalBSTR*pVal);生效日期 10.HRESULTCardEndTime(out,retvalBSTR*pVal);失效日期六、 返回值说明HRESULTResult(out,retva

14、llong*pVal);注：Result属性值表示以上所有指纹身份证操作函数被调用后所返回的结果，可以通过Result值判断操作成功还是失败。以下为Result可能会取到的返回值：1指纹操作时的返回值0x00成功0x01收包有错0x02传感器上无手指0x03录入指纹不成功0x04指纹图像太干、太淡而生不成特征0x05指纹图像太湿、太糊而生不成特征0x06指纹图像太乱而生不成特征值0x07指纹图像正常，但特征点太少(或面积太小)而生不成特征0x08指纹不匹配0x09没有搜索到相同的指纹0x0a合并失败（两枚指纹不属于同一手指）0x0b pageId超出指纹库范围(访问指纹库时地址序号超出指纹库范围)0x0c读出模板出错或模板无效0x0d上传特征指令执行失败0x0e不能接受后续数据包0x0f不能发送后续数据包0x10删除模板失败0x11清