（精選文檔）OCX控件二次開(kāi)發(fā)手冊(cè)指南

1、二次開(kāi)發(fā)說(shuō)明序：在調(diào)用OCX控件之前需要注冊(cè)O(shè)CX控件，在dos里輸入regsvr32 pathxxx.ocx可以實(shí)現(xiàn)OCX控件的注冊(cè)，輸入regsvr32 /u pathxxx.ocx可以注銷已經(jīng)注冊(cè)的OCX控件。如：注冊(cè)IdCardFingerCom.dll控件，regsvr32 C:Documents and Settings IdCardFingerCom.dll。IdCardFingerCom.dll控件的classid：1ABD01EC-2767-464B-93EE-12DA867464FA。需把2個(gè)動(dòng)態(tài)庫(kù)WltRS.dll、SynoAPIEx_CR20.dll和控件IdCardF

2、ingerCom.dll連同文件夾IdCardFingerCom整體放到C盤根目錄下(這步很重要，須嚴(yán)格按照要求來(lái)做)。如果需要通過(guò)IdCardFingerCom.dll控件操作android設(shè)備，則需要在android設(shè)備中安裝來(lái)打開(kāi)/關(guān)閉android設(shè)備下位機(jī)的電源(如：A320A和A370)。為需要用到的dll和ocx控件壓縮包。經(jīng)過(guò)測(cè)試IdCardFingerCom.dll控件支持javascript(目前僅支持IE瀏覽器)、c#、vb語(yǔ)言調(diào)用。為javascript、c#、vb語(yǔ)言調(diào)用控件的演示程序。一、 設(shè)備獲取、打開(kāi)說(shuō)明1. HRESULTPSGetUDiskNum(inint

3、deviceFlag,out,retvalint*deviceNum);功能說(shuō)明：獲取UDISK設(shè)備數(shù)，即獲取CR20/CR30/CR30A/A320A/A370的設(shè)備數(shù)。參數(shù)說(shuō)明：參數(shù)deviceFlag為入?yún)ⅲ禐?時(shí)表示獲取CR30/CR30A/A320A/A370設(shè)備數(shù)，值不為1時(shí)表示獲取CR20設(shè)備數(shù)。返回值說(shuō)明：參數(shù)deviceNum為返回值，表示獲取到的設(shè)備數(shù)目，小于等于0說(shuō)明未獲取到設(shè)備數(shù)2. HRESULTPSOpenDeviceEx(inintdeviceFlag);功能說(shuō)明：打開(kāi)CR20/CR30/CR30A/A320A/A370設(shè)備USB接口。參數(shù)說(shuō)明：參數(shù)device

4、Flag為入?yún)?，值?時(shí)表示打開(kāi)CR30/CR30A/A320A/A370設(shè)備，值不為1時(shí)表示打開(kāi)CR20設(shè)備。返回值說(shuō)明：無(wú)。可以通過(guò)(六)中的屬性Result的值來(lái)判斷為0表示打開(kāi)成功，否則打開(kāi)失敗。3. HRESULTPSCloseDeviceEx();功能說(shuō)明：關(guān)閉CR20/CR30/CR30A/A320A/A370設(shè)備USB接口。參數(shù)說(shuō)明：無(wú)。 返回值說(shuō)明：無(wú)?？梢酝ㄟ^(guò)(六)中的屬性Result的值來(lái)判斷為0表示打開(kāi)成功，否則打開(kāi)失敗。二、 指紋注冊(cè)功能流程圖三、 指紋驗(yàn)證流程圖1.一對(duì)一比對(duì)流程圖：2.一對(duì)多比對(duì)流程圖：四、 指紋功能方法說(shuō)明1. HRESULTPSGetImage

5、();功能說(shuō)明：檢測(cè)手指，檢測(cè)到后錄入指紋圖像存于ImageBuffer。參數(shù)說(shuō)明：無(wú)。返回值說(shuō)明：無(wú)2. HRESULTPSUpImage(out,retvalBSTR*imageData);功能說(shuō)明：將圖像緩沖區(qū)中的原始指紋圖像數(shù)據(jù)上傳給上位機(jī)。參數(shù)說(shuō)明：無(wú)返回值說(shuō)明：參數(shù)imageData為返回值，表示原始指紋圖像數(shù)據(jù) 注：調(diào)用此函數(shù)以后，可以通過(guò)HRESULTImageLength(out,retvallong*pVal);屬性值獲取指紋圖像數(shù)據(jù)的長(zhǎng)度。3. HRESULTPSImgData2BMP(inBSTRimageFile,inBSTR*imageData);功能說(shuō)明：將原始的

6、指紋圖像數(shù)據(jù)轉(zhuǎn)換為可視的指紋圖像參數(shù)說(shuō)明： imageFile入?yún)檗D(zhuǎn)換以后的指紋圖像路徑+圖片名，imageData入?yún)樵贾讣y圖像數(shù)據(jù)。返回值說(shuō)明：無(wú)4. HRESULTPSGenChar(inintbufferId);功能說(shuō)明：將ImageBuffer中的原始指紋圖像數(shù)據(jù)生成指紋特征文件存于CharBuffer1或者CharBuffer2中。參數(shù)說(shuō)明：參數(shù)bufferId為入?yún)ⅲ?bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)返回值說(shuō)明：無(wú)注：本文中的h表示十六進(jìn)制5. HRESULTPSRegModule();功能說(shuō)明：將CharBuffer1

7、 與CharBuffer2 中的特征文件合并生成模板，結(jié)果存于CharBuffer1 與CharBuffer2。參數(shù)說(shuō)明：無(wú)返回值說(shuō)明：無(wú)6. HRESULTPSUpChar(inintbufferId,out,retvalBSTR*templetData);功能說(shuō)明：將特征緩沖區(qū)中的特征文件上傳給上位機(jī)參數(shù)說(shuō)明：參數(shù)bufferId為入?yún)ⅲ琤ufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)。返回值說(shuō)明：templetData為返回值，表示上位機(jī)將要接收的指紋特征模板數(shù)據(jù)注：調(diào)用此函數(shù)以后，可以通過(guò)HRESULTTempletLength(out,retva

8、llong*pVal);屬性值獲取指紋特征模板數(shù)據(jù)的長(zhǎng)度。7. HRESULTPSDownChar(inintbufferId,in BSTR *templetData);功能說(shuō)明：上位機(jī)下載特征文件到模塊的一個(gè)特征緩沖區(qū)參數(shù)說(shuō)明：參數(shù)bufferId為入?yún)ⅲ?bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)，templetData入?yún)橄挛粰C(jī)將要接收的指紋特征模板數(shù)據(jù)。返回值說(shuō)明：無(wú)8. HRESULTPSMatch(out,retvalint*score);功能說(shuō)明：精確比對(duì)CharBuffer1和CharBuffer2中的特征文件參數(shù)說(shuō)明：無(wú)。返回值

9、說(shuō)明：score 為返回值，表示指紋比對(duì)得分9. HRESULTPSStoreChar(inintbufferId,inintpageId);功能說(shuō)明：將CharBuffer1或者CharBuffer2中的模板文件存到pageId號(hào)flash數(shù)據(jù)庫(kù)位置參數(shù)說(shuō)明：參數(shù)bufferId和pageId為入?yún)ⅲ?bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)，pageId為要存入flash庫(kù)的位置(該值為01023之間的數(shù))返回值說(shuō)明：無(wú)10.HRESULTPSSearch(inintbufferId,inintstartPage,inintpageNum,ou

10、t,retvalint*score);功能說(shuō)明：以CharBuffer1或者CharBuffer2中的特征文件搜索整個(gè)或部分指紋庫(kù)，若搜索到則返回頁(yè)碼。參數(shù)說(shuō)明：參數(shù)bufferId、startPage和pageNum為入?yún)? bufferId的值(1h表示CharBuffer1和2h表示CharBuffer2)，startPage為搜索起始頁(yè)，pageNum為搜索頁(yè)數(shù)(startPage為01023之間的數(shù)，iPageNum應(yīng)小于等于1023 - startPage)。返回值說(shuō)明：score為返回值，表示搜索指紋得分(搜索到的指紋和bufferID中的指紋特征值相似度越高，則得分越高)。注：

11、調(diào)用此函數(shù)以后，可以通過(guò)HRESULTMbAddress(out,retvallong*pVal);獲取搜索到的與當(dāng)前指紋匹配的指紋模板在指紋flash庫(kù)中的位置11. HRESULTPSEmpty();功能說(shuō)明：清空指紋flash庫(kù)參數(shù)說(shuō)明：無(wú)返回值說(shuō)明：無(wú)五、 身份證信息的獲取1.HRESULTPSUpIDCardData(inBSTRzpFile,out,retvalBSTR*idCardData); 功能說(shuō)明： 獲取身份證信息，解析身份證文本信息和照片信息，生成照片bmp文件，調(diào)用此函數(shù)以后可以通過(guò)以下的210的屬性值獲取身份證的姓名、性別、民族、生日、住址、身份證號(hào)碼、簽證機(jī)關(guān)、生效

12、日期和失效日期，并且可以在zpFile所設(shè)置的路徑+文件名下獲取到和zpFile相同文件名但不同擴(kuò)展名的照片文件(如：zpFile為zp.wlt，則照片文件為zp.bmp)參數(shù)說(shuō)明：zpFile為希望身份證照片生成路徑+文件名，文件必須以.wlt為擴(kuò)展名，如:D:zp.wlt 返回值說(shuō)明：idCardData為返回值，表示原始的身份證數(shù)據(jù)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);身份證號(hào)碼 8.HRESULTCardIssue(out,retvalBSTR*pVal);簽證機(jī)關(guān) 9.HRESULTCardStartTime(out,retvalBSTR*pVal);生效日期 10.HRESULTCardEndTime(out,retvalBSTR*pVal);失效日期六、 返回值說(shuō)明HRESULTResult(out,retva

14、llong*pVal);注：Result屬性值表示以上所有指紋身份證操作函數(shù)被調(diào)用后所返回的結(jié)果，可以通過(guò)Result值判斷操作成功還是失敗。以下為Result可能會(huì)取到的返回值：1指紋操作時(shí)的返回值0x00成功0x01收包有錯(cuò)0x02傳感器上無(wú)手指0x03錄入指紋不成功0x04指紋圖像太干、太淡而生不成特征0x05指紋圖像太濕、太糊而生不成特征0x06指紋圖像太亂而生不成特征值0x07指紋圖像正常，但特征點(diǎn)太少(或面積太小)而生不成特征0x08指紋不匹配0x09沒(méi)有搜索到相同的指紋0x0a合并失敗（兩枚指紋不屬于同一手指）0x0b pageId超出指紋庫(kù)范圍(訪問(wèn)指紋庫(kù)時(shí)地址序號(hào)超出指紋庫(kù)范圍)0x0c讀出模板出錯(cuò)或模板無(wú)效0x0d上傳特征指令執(zhí)行失敗0x0e不能接受后續(xù)數(shù)據(jù)包0x0f不能發(fā)送后續(xù)數(shù)據(jù)包0x10刪除模板失敗0x11清