您的当前位置：首页 IDCard.OCX控件使用说明

IDCard.OCX控件使用说明

来源：九壹网

IDCard.ocx控件

控件文件名：IDCard.ocx，以下我们对身份证件扫描识别控件IDCard.ocx的接口等进行阐述。

控件运行环境：若该控件用于IE，需要将扫描识别核心库拷贝到IE的目录：

C:\\Program Files\\Internet Explorer；

否则,要将扫描识别核心库拷贝到使用该控件的可执行文件(EXE)所在目录。属性：

// 具有通知特性的可写属性

BSTR IDCardLibPath 表示扫描识别库所在的路径; 若控件在B/S结构的程序中使用，请先

设置该属性。比如：C:\\Program Files\\Internet Explorer\\DLL&LIB

// 只写属性

BSTR ImageFileName

所要识别或扫描识别的图像文件的文件名（绝对路径），文件的扩展名只能是

BMP/bmp/tif/TIF/jpg/JPG; BOOL SaveResultFile

是否保存识别结果文件；如果为TRUE，则保存识别结果文件，识别结果将保存在与

ImageFileName相对应的文本文件中，例如,

如果ImageFileName =“c:\\\\idcardFolder\\\\idcard1.bmp”，则对应的文本文件为“c:\\\\idcardFolder\\\\idcard1_result.txt”；如果为FALSE则不保存识别结果文件。

short HandPrint 表示身份证手写印刷标志 0-自动判别 1-印刷证 2-手写证； short Content 表示识别内容选项;参考下面各个识别功能的详细说明； BSTR HeadImageFileName

表示头像图像的文件名（绝对路径），提取生成的头像将保存在该文件中；

如果是NULL就不给出照片文件；文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG； short ButtonType

当扫描识别身份证件时,表示扫描识别不同类型的证件,其值只能为1,2,3之一； 1 表示扫描识别不带防伪的身份证； 3 示扫描识别带防伪的身份证；

2 表示扫描其它证件，得到普通的灰度图像而不进行识别。使用时可以根据按下不同按钮的值来扫描识别不同的身份证件；当仅仅扫描身份证件时，请看接口ScanImageEx的详细说明。

接口：

// 加载、卸载扫描识别核心 BOOL Load( void ); void Free( void );

// 判断扫描识别核心是否加载成功

BOOL LibIsLoaded( void );

// 各种证件的识别功能

BOOL RecogIdcardOnlyALL() BOOL RecogIdcardExALL()

BOOL RecogNewIdcardOnlyALL() BOOL RecogNewIdcardALL()

BOOL RecogDPOnlyALL() BOOL RecogDPALL()

BOOL RecogPassPortOnlyALL() BOOL RecogPassPortALL()

// 获得识别结果 BSTR GetName(); BSTR GetSex(); BSTR GetPeople(); BSTR GetBirthday(); BSTR GetAddress(); BSTR GetSignDate(); BSTR GetValidTerm(); BSTR GetNumber(); BSTR GetOther();

// 扫描图像

BOOL ScanImageEx();

// 获得最后一次的错误信息 BSTR GetLastErrorInfo();

/********************************************************/ // 加载、卸载扫描识别核心

/********************************************************/ 接口方法：BOOL Load() 功能：加载扫描识别核心。参数：输入/输出参数：无；

返回值：TRUE 扫描识别核心加载成功；FALSE 扫描识别核心加载失败；

接口方法：void Free()

功能：卸载扫描识别核心。参数：输入/输出参数：无；返回值：无；

/********************************************************/ // 判断扫描识别核心是否加载成功

/********************************************************/ 接口方法：BOOL LibIsLoaded()

功能：判断扫描识别核心是否加载成功。参数：输入/输出参数：无；

返回值：TRUE 扫描识别核心加载成功；FALSE 扫描识别核心加载失败；注意： 1．在调用各种证件的识别功能之前，必须先调用该方法判断识别核心是否加载； 2．通过该接口方法可以判断扫描识别核心是否加载成功；

3．加载失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得；

/********************************************************/ // 各种证件的识别功能

/********************************************************/ 接口方法：BOOL RecogIDCardOnlyALL()

功能：对已有的身份证图像文件进行识别，包括签发日期和有效期的识别；参数：输入/输出参数：无；

返回值：TRUE识别成功；FALSE识别失败; 注意： 1.识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得；

2.在调用该接口方法之前，必须先 a. 设置属性 BSTR ImageFileName; b. 设置属性BOOL SaveResultFile; c. 设置属性short HandPrint; d. 设置属性short Content;

e. 设置属性BSTR HeadImageFileName;

ImageFileName是所要识别身份证图像文件的路径名（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

SaveResultFile 是否保存识别结果，如果为TRUE，则识别结果文件，识别结果将保存在与ImageFileName相对应的文本文件中，例如,如果ImageFileName =“c:\\\\idcardFolder\\\\idcard1.bmp”，则对应的文本文件为“c:\\\\idcardFolder\\\\idcard1_result.txt”

HandPrint 身份证手写印刷标志 0-自动判别 1-印刷证 2-手写证；

Content 识别内容选项，只用了最低的六个比特。例如，我们要识别姓名和编号两项，其他不识别，那么通过位运算0x00000001&0x00000010得nContent为0x00000011，即nContent=17。姓名 0x00000001 性别民族 0x00000002 生日 0x00000004

地址 0x00000008

编号 0x00000010 签发 0x00000020

HeadImageFileName人头照片的文件名（绝对路径），如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将不生成头像文件。

接口方法：BOOL RecogNewIDCardOnlyALL()

功能：对已有的二代证图像文件进行识别，包括身份证号码、姓名、性别、民族、出生日期和住址的识别。

参数：输入/输出参数：无；

返回值：TRUE识别成功；FALSE识别失败; 注意：

1.识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得； 2. 在调用该接口方法之前，必须先 a. 设置属性 BSTR ImageFileName; b. 设置属性BOOL SaveResultFile; c. 设置属性short Content;

d. 设置属性BSTR HeadImageFileName;

ImageFileName是所要识别二代证图像文件的路径名（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项，其他不识别，那么通过位运算0x00000001&0x00000010得nContent为0x00000011，即nContent=17。姓名 0x00000001 性别民族 0x00000002 生日 0x00000004 地址 0x00000008 编号 0x00000010

HeadImageFileName人头照片的文件名(绝对路径)，如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将不生成头像文件。

接口方法：BOOL RecogDPOnlyALL()

功能：对已有的驾证图像文件进行识别,包括身份证号码、姓名、性别、出生日期和住址的识别。

参数：输入/输出参数：无；

返回值：TRUE识别成功；FALSE识别失败; 注意：

1. 识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得； 2. 在调用该接口方法之前，必须先 a. 设置属性 BSTR ImageFileName; b. 设置属性BOOL SaveResultFile; c. 设置属性short Content;

d. 设置属性BSTR HeadImageFileName;

ImageFileName所要识别驾照图像文件的路径名（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项，其他不识别，那么通过位运算0x00000001&0x00000010得nContent为0x00000011，即nContent=17。

姓名 0x00000001 性别民族 0x00000002 生日 0x00000004 地址 0x00000008 编号 0x00000010

HeadImageFileName人头照片的文件名(绝对路径)，如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将不生成头像文件.

接口方法：BOOL RecogPassportOnlyALL( )

功能：对已有的护照图像文件进行识别，包括护照编号、类别、姓名、性别、出生日期、

有效期至和国籍的识别。参数：输入/输出参数：无；

返回值：TRUE识别成功；FALSE识别失败; 注意：

1. 识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得； 2. 在调用该接口方法之前，必须先 a. 设置属性 BSTR ImageFileName; b. 设置属性 BOOL SaveResultFile; c. 设置属性 short Content;

d. 设置属性BSTR HeadImageFileName;

ImageFileName是所要识别护照图像文件的路径名（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项，其他不识别，那么通过位运算0x00000001&0x00000010得nContent为0x00000011，即nContent=17。（目前不支持此项，只能全部识别，请设置该值为31：表示全部识别。）

姓名 0x00000001

性别 0x00000002

生日 0x00000004

国籍 0x00000008

编号 0x00000010

有效期至 0x00000020

HeadImageFileName 人头照片的文件名（绝对路径），如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将不生成头像文件。

接口方法：BOOL RecogIDCardExALL( )

功能：可以对新旧不同身份证的扫描和识别，包括签发日期和有效期的识别。参数：输入/输出参数：无;

返回值：TRUE 识别成功；FALSE识别失败; 注意：

1. 识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得； 2. 在调用该接口方法之前，必须先 a. 设置属性 BSTR ImageFileName; b. 设置属性BOOL SaveResultFile; c. 设置属性short HandPrint; d. 设置属性short Content;

e. 设置属性BSTR HeadImageFileName; f. 设置属性short ButtonType;

ImageFileName扫描生成的身份证图像将保存在该文件中（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

HandPrint 身份证手写印刷标志 0-自动判别 1-印刷证 2-手写证；

Content 识别内容选项，只用了最低的六个比特。例如，我们要识别姓名和编号两项，其他不识别，那么通过位运算0x00000001&0x00000010得nContent为0x00000011，即nContent=17。

姓名 0x00000001

性别民族 0x00000002

生日 0x00000004

地址 0x00000008

编号 0x00000010

签发 0x00000020

ButtonType 表示扫描识别不同类型的证件， 1 表示扫描识别不带防伪的身份证；3 示

扫描识别带防伪的身份证；2表示扫描其它证件，得到普通的灰度图像而不进行识别。使用时可以根据按下不同按钮的值来扫描识别不同的身份证件。

接口方法：BOOL RecogNewIDCardALL( )

功能：实现对二代证的扫描和识别，识别内容包括身份证号码、姓名、性别、民族、

出生日期和住址等。参数：输入/输出参数：无；

返回值：TRUE 识别成功；FALSE 识别失败; 注意：

d. 设置属性BSTR HeadImageFileName;

ImageFileName扫描生成的二代证图像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

接口方法：BOOL RecogDPALL()

功能: 实现对驾照的扫描和识别,识别内容包括身份证号码、姓名、性别、出生日期和住址等。参数：输入/输出参数：无；

返回值：TRUE 识别成功；FALSE识别失败; 注意： 1. 识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得；

2. 在调用该接口方法之前，必须先 a. 设置属性 BSTR ImageFileName; b. 设置属性Bool SaveResultFile; c. 设置属性short Content;

d. 设置属性BSTR HeadImageFileName;

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

接口方法：BOOL RecogPassportALL()

功能: 实现对护照的扫描和识别，识别内容包括护照编号、姓名、性别、出生日期国籍和

有效期至等。

参数：输入/输出参数：无；

返回值：TRUE识别成功；FALSE识别失败; 注意： 1.识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得； 2. 在调用该接口方法之前，必须先

a. 设置属性 BSTR ImageFileName; b. 设置属性BOOL SaveResultFile; c. 设置属性short Content;

d. 设置属性BSTR HeadImageFileName;

ImageFileName扫描生成的护照图像将保存在该文件中（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；

姓名 0x00000001

性别 0x00000002

生日 0x00000004

国籍 0x00000008

编号 0x00000010

有效期至 0x00000020

/********************************************************/ // 获得识别结果

/********************************************************/ 接口方法：BSTR GetName(); 功能：获得识别结果中的姓名; 参数：输入/输出参数：无；

返回值：识别结果中的姓名或者NULL；注意：

该方法必须在调用识别方法成功后使用。