IDCardOCX控件使用说明.docx
- 文档编号:9402007
- 上传时间:2023-02-04
- 格式:DOCX
- 页数:28
- 大小:19.50KB
IDCardOCX控件使用说明.docx
《IDCardOCX控件使用说明.docx》由会员分享,可在线阅读,更多相关《IDCardOCX控件使用说明.docx(28页珍藏版)》请在冰豆网上搜索。
IDCardOCX控件使用说明
IDCard.ocx控件
控件文件名:
IDCard.ocx,适用于AVA6证件扫描仪。
以下我们对身份证件扫描识别控件IDCard.ocx的接口等进行阐述。
注册控件:
在使用本控件前请先注册。
可用regsvr32命令来实现对控件的注册,用regsvr32/u命令删除已经注册的ActiveX控件信息。
控件运行环境:
若该控件用于IE,需要将扫描识别核心库拷贝到IE的目录:
C:
\ProgramFiles\InternetExplorer;
否则,要将扫描识别核心库拷贝到使用该控件的可执行文件(EXE)所在目录。
注意:
本控件在构造函数里加载识别核心库,在析购函数里卸载识别核心库,所以用户在使用时不需要加载和卸载识别核心库。
在调用本控件提供的其他接口前,可调用LibIsLoaded()函数来判断识别核心是否加载成功,如果返回值为TRUE扫描识别核心加载成功;FALSE扫描识别核心加载失败。
属性:
//只写属性
BSTRImageFileName
所要识别或扫描识别的图像文件的文件名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG;
BOOLSaveResultFile
是否保存识别结果文件;如果为TRUE,则保存识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,
如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,
则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”;
如果为FALSE则不保存识别结果文件。
shortContent表示识别内容选项;参考下面各个识别功能的详细说明;
BSTRHeadImageFileName
表示头像图像的文件名(绝对路径),提取生成的头像将保存在该文件中;
如果是NULL就不给出照片文件;文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG;
shortButtonType
当调用ScanImageEx()扫描身份证件时,表示扫描不同类型的证件
1或3表示扫描一代身份证;
2表示扫描驾照;
4表示扫描护照或港澳通行证;
6表示扫描二代证或者回乡证;
10表示全幅彩色扫描;
16表示扫描军官证。
接口:
//判断扫描识别核心是否加载成功
BOOLLibIsLoaded(void);
//获得最后一次的错误信息
BSTRGetLastErrorInfo();
//各种证件的识别功能
BOOLRecogIdcardOnlyALL()
BOOLRecogIdcardExALL()
BOOLRecogNewIdcardOnlyALL()
BOOLRecogNewIdcardALL()
BOOLRecogDPOnlyALL()
BOOLRecogDPALL()
BOOLRecogPassPortOnlyALL()
BOOLRecogPassPortALL()
BOOLRecogLaissezPasserOnlyALL();
BOOLRecogLaissezPasserALL();
BOOLRecogLicenseOnlyALL();
BOOLRecogLicenseALL();
BOOLRecogSoldieryCardOnlyALL();
BOOLRecogSoldieryCardALL();
BOOLRecogNewIdBackOnlyALL();
BOOLRecogNewIdBackALL();
BOOLRecogVehicleLicenseEXALL();
BOOLRecogVehicleLicenseEXOnlyALL();
BOOLRecogVisaALL();
BOOLRecogVisaOnlyALL();
//判断AVA6扫描仪是否在线
BOOLCheckAVA6Scanner();
//检测用户ID是否正确
BOOLCheckA6GreenSI(LPCTSTRlpszUserID);
//获得识别结果
BSTRGetName();
BSTRGetSex();
BSTRGetPeople();
BSTRGetBirthday();
BSTRGetAddress();
BSTRGetSignDate();
BSTRGetValidTerm();
BSTRGetNumber();
BSTRGetOther();
//扫描图像
BOOLScanImageEx();
/********************************************************/
//判断扫描识别核心是否加载成功
/********************************************************/
接口方法:
BOOLLibIsLoaded()
功能:
判断扫描识别核心是否加载成功。
参数:
输入/输出参数:
无;
返回值:
TRUE扫描识别核心加载成功;FALSE扫描识别核心加载失败;
注意:
1.在调用各种证件的识别功能之前,必须先调用该方法判断识别核心是否加载;
2.通过该接口方法可以判断扫描识别核心是否加载成功;
3.加载失败的信息可以通过接口方法voidGetLastErrorInfo()获得;
/********************************************************/
//获取最近一次的错误信息
/********************************************************/
接口方法:
BSTRGetLastErrorInfo();
功能:
获取最近一次的错误信息;
参数:
输入/输出参数:
无;
返回值:
最近一次的错误信息;或者NULL;
注意:
1.调用该方法,只能得到最近一次的错误信息;
2.在调用下面说明的任何一个函数时如果出现错误,都可以通过GetLastErrorInfo()函数获得最近一次的出错信息。
/********************************************************/
//各种证件的识别功能
/********************************************************/
接口方法:
BOOLRecogIDCardOnlyALL()
功能:
对已有的一代身份证图像文件进行识别,包括签发日期和有效期的识别;
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别身份证图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的六个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
签发0x00000020
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogNewIDCardOnlyALL()
功能:
对已有的二代证图像文件进行识别,包括身份证号码、姓名、性别、民族、出生日期和住址的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别二代证图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogDPOnlyALL()
功能:
对已有的驾证图像文件进行识别,包括身份证号码、姓名、性别、出生日期和住址的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName所要识别驾照图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件.
接口方法:
BOOLRecogPassportOnlyALL()
功能:
对已有的护照图像文件进行识别,包括护照编号、类别、姓名、性别、出生日期、
有效期至和国籍的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别护照图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
(目前不支持此项,只能全部识别,请设置该值为31:
表示全部识别。
)
姓名0x00000001
性别0x00000002
生日0x00000004
国籍0x00000008
编号0x00000010
有效期至0x00000020
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogVisaOnlyALL()
功能:
对已有的签证图像文件进行识别,包括签证编号、类别、姓名、性别、出生日期、
有效期至和国籍的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName是所要识别签证图像文件的路径名(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
(目前不支持此项,只能全部识别,请设置该值为31:
表示全部识别。
)
姓名0x00000001
性别0x00000002
生日0x00000004
国籍0x00000008
编号0x00000010
有效期至0x00000020
接口方法:
BOOLRecogVisaALL()
功能:
实现对签证的拍照和识别,识别内容包括签证编号、姓名、性别、出生日期国籍和
有效期至等。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName拍照生成的签证图像将保存在该文件中(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
(目前不支持此项,只能全部识别,请设置该值为31:
表示全部识别。
)
姓名0x00000001
性别0x00000002
生日0x00000004
国籍0x00000008
编号0x00000010
有效期至0x00000020
接口方法:
BOOLRecogIDCardExALL()
功能:
可以对新旧不同的一代身份证进行扫描和识别,包括签发日期和有效期的识别。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName扫描生成的身份证图像将保存在该文件中(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
签发0x00000020
Content识别内容选项,只用了最低的六个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogNewIDCardALL()
功能:
实现对二代证的扫描和识别,识别内容包括身份证号码、姓名、性别、民族、
出生日期和住址等。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BOOLSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName扫描生成的二代证图像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出照片文件,提取生成的头像将保存在该文件中,文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将不生成头像文件。
接口方法:
BOOLRecogDPALL()
功能:
实现对驾照的扫描和识别,识别内容包括身份证号码、姓名、性别、出生日期和住址等。
参数:
输入/输出参数:
无;
返回值:
TRUE识别成功;FALSE识别失败;
注意:
在调用该接口方法之前,必须先
a.设置属性BSTRImageFileName;
b.设置属性BoolSaveResultFile;
c.设置属性shortContent;
d.设置属性BSTRHeadImageFileName;
ImageFileName扫描生成的驾照图像将保存在该文件中(绝对路径),文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;
SaveResultFile是否保存识别结果,如果为TRUE,则保存识别结果文件,识别结果将保存在与ImageFileName相对应的文本文件中,例如,如果ImageFileName=“c:
\\idcardFolder\\idcard1.bmp”,则对应的文本文件为“c:
\\idcardFolder\\idcard1_result.txt”
姓名0x00000001
性别民族0x00000002
生日0x00000004
地址0x00000008
编号0x00000010
Content识别内容选项,只用了最低的五个比特。
例如,我们要识别姓名和编号两项,其他不识别,那么通过位运算0x00000001&0x00000010得nContent为0x00000011,即nContent=17。
HeadImageFileName人头照片的文件名(绝对路径),如果是NULL就不给出
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- IDCardOCX 控件 使用说明