IDCardOCX控件使用说明

1、IDCard.ocx 控件控件文件名：IDCard.ocx，以下我们对身份证件扫描识别控件IDCard.ocx 的接口等进行阐述。控件运行环境：若该控件用于IE,需要将扫描识别核心库拷贝到IE的目录：C:Program FilesInternet Explorer；否则，要将扫描识别核心库拷贝到使用该控件的可执行文件(EXE)所在目录。 属性：/ 具有通知特性的可写属性BSTR IDCardLibPath表示扫描识别库所在的路径；若控件在B/S结构的程序中使用，请先 设置该属性。比如： C:Program FilesInternet ExplorerDLL&LIB/ 只写属性BSTR Imag

2、eFileName所要识别或扫描识别的图像文件的文件名(绝对路径) ，文件的扩展名只能是 BMP/bmp/tif/TIF/jpg/JPG；BOOL SaveResultFile是否保存识别结果文件；如果为TRUE，则保存识别结果文件，识别结果将保存在与 ImageFileName 相对应的文本文件中，例如，如果 ImageFileName =“c:idcardFolderidcard1.bmp”，则对应的文本文件为 “c:idcardFolderidcardl_result.txt”； 如果为FALSE则不保存识别结果文件。short HandPrint表示身份证手写印刷标志0-自动判别1-印

3、刷证2-手写证；short Content表示识别内容选项；参考下面各个识别功能的详细说明；BSTR HeadImageFileName表示头像图像的文件名(绝对路径)，提取生成的头像将保存在该文件中；如果是NULL就不给出照片文件；文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG； short ButtonType当扫描识别身份证件时，表示扫描识别不同类型的证件，其值只能为 1，2，3 之一；表示扫描识别不带防伪的身份证；3 示扫描识别带防伪的身份证；表示扫描其它证件，得到普通的灰度图像而不进行识别。 使用时可以根据按下不同按钮的值来扫描识别不同的身份证件； 当仅仅扫描身份证

4、件时，请看接口 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

5、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()功能：加载扫描识别核心。 参数：输入/输出参数：无；返回

6、值：TRUE扫描识别核心加载成功；FALSE扫描识别核心加载失败;接口方法： void Free() 功能：卸载扫描识别核心。 参数：输入/输出参数：无 返回值：无；/ 判断扫描识别核心是否加载成功接口方法：BOOL LibIsLoaded()功能：判断扫描识别核心是否加载成功。参数：输入/输出参数：无；返回值：TRUE扫描识别核心加载成功；FALSE扫描识别核心加载失败;1在调用各种证件的识别功能之前，必须先调用该方法判断识别核心是否加载；2通过该接口方法可以判断扫描识别核心是否加载成功；3 .加载失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErro

7、rInfo )获得;/ 各种证件的识别功能接口方法：BOOL RecogIDCardOnlyALL()功能：对已有的身份证图像文件进行识别，包括签发日期和有效期的识别 参数：输入/输出参数：无；返回值：TRUE识别成功；FALSE识别失败；识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得;在调用该接口方法之前，必须先设置属性 BSTR ImageFileName；设置属性 BOOL SaveResultFile；设置属性 short HandPrint；设置属性 short Content；设置属性 BSTR HeadImag

8、eFileName；ImageFileName 是所要识别身份证图像文件的路径名(绝对路径)，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;SaveResultFile是否保存识别结果，如果为TRUE，则识别结果文件，识别结果将保存在 与 ImageFileName 相 对 应 的 文 本 文 件 中 , 例 如 , 如 果 ImageFileName = “c:idcardFolderidcard1.bmp”，则对应的文本文件为 “c:idcardFolderidcard1_result.txt”HandPrint 身份证手写印刷标志 0-自动判别

9、 1-印刷证 2-手写证；Content 识别内容选项，只用了最低的六个比特。例如，我们要识别姓名和编号两项其他不识别，那么通过位运算0 x00000001 &0X00000010得nContent为0 x00000011,即nContent=17。姓名 0 x00000001 性别民族0 x00000002 生日 0 x00000004 地址 0 x00000008 编号 0 x00000010 签发 0 x00000020HeadlmageFileName人头照片的文件名(绝对路径)，如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif

10、/TIF/jpg/JPG,否则将 不生成头像文件。接口方法：BOOL RecogNewIDCardOnlyALL()功能：对已有的二代证图像文件进行识别，包括身份证号码、姓名、性别、民族、出生日期 和住址的识别。参数： 输入/输出参数：无；返回值：TRUE识别成功；FALSE识别失败；识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得;在调用该接口方法之前，必须先设置属性 BSTR ImageFileName；设置属性 BOOL SaveResultFile；设置属性 short Content；d. 设置属性 d. 设置属性

11、BSTRHeadImageFileName；ImageFileName 是所要识别二代证图像文件的路径名(绝对路径)，文件的扩展名只能 是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出;SaveResultFile是否保存识别结果，如果为TRUE，则识别结果文件，识别结果将保存在 与 ImageFileName 相 对 应 的 文 本 文 件 中 ， 例 如 , 如 果 ImageFileName = “c:idcardFolderidcard1.bmp”，则对应的文本文件为 “c:idcardFolderidcard1_result.txt”Content 识别内容选

12、项，只用了最低的五个比特。例如，我们要识别姓名和编号两项， 其他不识别，那么通过位运算0 x00000001 &0X00000010得nContent为0 x00000011,即 nContent=17。姓名 0 x00000001 性别民族0 x00000002 生日 0 x00000004 地址 0 x00000008 编号 0 x00000010HeadImageFileName人头照片的文件名(绝对路径)，如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将 不生成头像文件。接口方法： BOOL Re

13、cogDPOnlyALL()功能：对已有的驾证图像文件进行识别,包括身份证号码、姓名、性别、出生日期和住址的 识别。参数： 输入/输出参数：无；返回值：TRUE识别成功；FALSE识别失败；1. 识别失败的信息可以通过接口方法 void GetLastErrorInfo（ BSTR *pErrorInfo ）获得2. 在调用该接口方法之前，必须先设置属性 BSTR ImageFileName;设置属性 BOOL SaveResultFile;设置属性 short Content;d. 设置属性 d. 设置属性 BSTRHeadImageFileName;ImageFileName 所要识别驾照

14、图像文件的路径名（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出;SaveResultFile是否保存识别结果，如果为TRUE，则识别结果文件，识别结果将保存在 与 ImageFileName 相 对 应 的 文 本 文 件 中 , 例 如 , 如 果 ImageFileName = “c:idcardFolderidcardl.bmp”，则对应的文本文件为 “c:idcardFolderidcardl_result.txt”Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项 其他不识别，那么通过位运算0 x

15、00000001 &0X00000010得nContent为0 x00000011,即 nContent=l7。姓名 0 x00000001 性别民族0 x00000002 生日 0 x00000004 地址 0 x00000008 编号 0 x00000010HeadlmageFileName人头照片的文件名（绝对路径），如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将 不生成头像文件.接口方法：BOOL RecogPassportOnlyALL（）功能：对已有的护照图像文件进行识别，包括护照编号、类别

16、、姓名、性别、出生日期 有效期至和国籍的识别。参数： 输入/输出参数：无;返回值：TRUE识别成功；FALSE识别失败；1.2.a.b.1.2.a.b.c.d.设置属性 BSTR ImageFileName； 设置属性 BOOL SaveResultFile； 设置属性 short Content；设置属性 BSTR HeadImageFileName；ImageFileName 是所要识别护照图像文件的路径名（绝对路径），文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；SaveResultFile是否保存识别结果，如果为TRUE，则识别结果文件，识别

17、结果将保存 在 与 ImageFileName 相 对 应 的 文 本 文 件 中 ， 例 如 , 如 果 ImageFileName = “c:idcardFolderidcard1.bmp”，则对应的文本文件为 “c:idcardFolderidcard1_result.txt”Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项，其他不识别，那么通过位运算0 x00000001 &0 x00000010得nContent为0 x00000011，即 nContent=17。（目前不支持此项，只能全部识别，请设置该值为31：表示全部识别。）姓名0 x00000

18、001性别0 x00000002生日0 x00000004国籍0 x00000008编号0 x00000010有效期至0 x00000020HeadImageFileName 人头照片的文件名（绝对路径），如果是 NULL 就不给出照片 文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是 BMP/bmp/tif/TIF/jpg/JPG， 否则将不生成头像文件。接口方法：BOOL RecogIDCardExALL（） 功能：可以对新旧不同身份证的扫描和识别，包括签发日期和有效期的识别。 参数： 输入/输出参数：无;返回值：TRUE识别成功；FALSE识别失败；识别失败的信息可以通过接口方

19、法void GetLastErrorInfo（ BSTR *pErrorInfo ）获得；在调用该接口方法之前，必须先设置属性 BSTR ImageFileName；设置属性 BOOL SaveResultFile；设置属性 short HandPrint；设置属性 short Content；设置属性 BSTR HeadImageFileName；设置属性 short ButtonType；ImageFileName 扫描生成的身份证图像将保存在该文件中（绝对路径），文件的扩展名 只能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；SaveResultFile是否保

20、存识别结果，如果为TRUE，则识别结果文件，识别结果将保存 在 与 ImageFileName 相 对 应 的 文 本 文 件 中 ， 例 如 , 如 果 ImageFileName = “c:idcardFolderidcardl.bmp”，则对应的文本文件为 “c:idcardFolderidcardl_result.txt”HandPrint 身份证手写印刷标志 0-自动判别 1-印刷证 2-手写证；Content 识别内容选项，只用了最低的六个比特。例如，我们要识别姓名和编号两项， 其他不识别，那么通过位运算0 x00000001 &0X00000010得nContent为0 x000

21、00011,即 nContent=17。姓名0 x00000001性别民族0 x00000002生日0 x00000004地址0 x00000008编号0 x00000010签发0 x00000020HeadlmageFileName人头照片的文件名（绝对路径），如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将 不生成头像文件。ButtonType 表示扫描识别不同类型的证件， 1 表示扫描识别不带防伪的身份证； 3 示 扫描识别带防伪的身份证；2 表示扫描其它证件，得到普通的灰度图像而不进行识别。使用

22、时可以根据按下不同按钮的值来扫描识别不同的身份证件。接口方法：BOOL RecogNewIDCardALL()功能：实现对二代证的扫描和识别，识别内容包括身份证号码、姓名、性别、民族 出生日期和住址等。参数： 输入/输出参数：无；返回值：TRUE识别成功；FALSE识别失败；1.识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得;2. 在调用该接口方法之前，必须先设置属性 BSTR ImageFileName；设置属性 BOOL SaveResultFile；设置属性 short Content；设置属性 BSTR HeadIm

23、ageFileName；ImageFileName 扫描生成的二代证图像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将以识别失败而退出；SaveResultFile是否保存识别结果，如果为TRUE，则识别结果文件，识别结果将保存在 与 ImageFileName 相 对 应 的 文 本 文 件 中 , 例 如 , 如 果 ImageFileName =“c:idcardFolderidcard1.bmp”，则对应的文本文件为 “c:idcardFolderidcard1_result.txt”Content 识别内容选项，只用了最低的五个比特。例如，

24、我们要识别姓名和编号两项， 其他不识别，那么通过位运算0 x00000001 &0X00000010得nContent为0 x00000011,即 nContent=17。姓名 0 x00000001 性别民族0 x00000002 生日 0 x00000004 地址 0 x00000008 编号 0 x00000010HeadlmageFileName人头照片的文件名(绝对路径)，如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将 不生成头像文件。接口方法： BOOL RecogDPALL()功能: 实现

25、对驾照的扫描和识别,识别内容包括身份证号码、姓名、性别、出生日期和住址等 参数： 输入/输出参数：无； 返回值：TRUE识别成功；FALSE识别失败;、，亠-7-.注意：识别失败的信息可以通过接口方法void GetLastErrorInfo( BSTR *pErrorInfo )获得；在调用该接口方法之前，必须先设置属性 BSTR ImageFileName;设置属性 Bool SaveResultFile;设置属性 short Content;设置属性 BSTR HeadImageFileName;ImageFileName 扫描生成的驾照图像将保存在该文件中（绝对路径），文件的扩展名只

26、能是BMP/bmp/tif/TIF/jpg/JPG，否则将以识别失败而退出；SaveResultFile是否保存识别结果，如果为TRUE，则保存识别结果文件，识别结果将 保 存 在 与 ImageFileName 相 对 应 的 文 本 文 件 中 ， 例 如 , 如 果 ImageFileName =“c:idcardFolderidcardl.bmp”，则对应的文本文件为 “c:idcardFolderidcardl_result.txt”Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项， 其他不识别，那么通过位运算0 x00000001 &0X00000

27、010得nContent为0 x00000011,即 nContent=17。姓名0 x00000001性别民族0 x00000002生日0 x00000004地址0 x00000008编号0 x00000010HeadlmageFileName人头照片的文件名（绝对路径），如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG，否则将 不生成头像文件。接口方法：BOOL RecogPassportALL（）功能: 实现对护照的扫描和识别，识别内容包括护照编号、姓名、性别、出生日期国籍和 有效期至等。参数： 输入/输出

28、参数：无；返回值：TRUE识别成功；FALSE识别失败；1.识别失败的信息可以通过接口方法void GetLastErrorInfo（ BSTR *pErrorInfo ）获得;2. 在调用该接口方法之前，必须先设置属性 BSTR设置属性 BSTR设置属性 BOOL设置属性 short设置属性 BSTRImageFileName； SaveResultFile； Content； HeadImageFileName；姓名 性别 生日 国籍 编号 有效期至姓名 性别 生日 国籍 编号 有效期至ImageFileName扫描生成的护照图像将保存在该文件中（绝对路径），文件的扩展名只能是BMP/bm

29、p/tif/TIF/jpg/JPG，否则将以识别失败而退出;SaveResultFile是否保存识别结果，如果为TRUE，则识别结果文件，识别结果将保存在 与 ImageFileName 相 对 应 的 文 本 文 件 中 ， 例 如 , 如 果 ImageFileName =“c:idcardFolderidcard1.bmp”，则对应的文本文件为 “c:idcardFolderidcard1_result.txt”Content 识别内容选项，只用了最低的五个比特。例如，我们要识别姓名和编号两项 其他不识别，那么通过位运算0 x00000001 &0 x00000010得nContent为

30、0 x00000011，即 nContent=17。（目前不支持此项，只能全部识别，请设置该值为31：表示全部识别。） 0 x000000010 x000000020 x000000040 x000000080 x000000100 x00000020HeadlmageFileName人头照片的文件名(绝对路径)，如果是NULL就不给出照片文件, 提取生成的头像将保存在该文件中，文件的扩展名只能是BMP/bmp/tif/TIF/jpg/JPG,否则将 不生成头像文件。/ 获得识别结果接口方法：BSTR GetName();功能：获得识别结果中的姓名; 参数： 输入/输出参数：无；返回值：识别结

31、果中的姓名或者NULL；该方法必须在调用识别方法成功后使用。如果返回NULL，可以通过接口方法BSTR GetLastErrorInfo()获得失败的信息;接口方法： BSTR GetSex();功能：获得识别结果中的性别。参数： 输入/输出参数：无；返回值：识别结果中的性别或者NULL；该方法必须在调用识别方法成功后使用。如果返回NULL，可以通过接口方法BSTR GetLastErrorInfo()获得失败的信息;接口方法：BSTR GetPeople();功能：获得识别结果中的民族，护照识别时此项为空 参数：输入/输出参数：无；返回值：识别结果中的民族，护照识别时此项为空；或者NULL；

32、该方法必须在调用识别方法成功后使用。如果返回NULL，可以通过接口方法BSTR GetLastErrorInfo()获得失败的信息;接口方法： BSTR GetBirthday();功能：获得识别结果中的出生日期参数：输入/输出参数：无；返回值：识别结果中的出生日期或者NULL；该方法必须在调用识别方法成功后使用。如果返回NULL，可以通过接口方法BSTR GetLastErrorInfo()获得失败的信息;接口方法：BSTR GetAddress();功能：获得识别结果中的地址，在识别护照时导出的是国籍简码 参数：输入/输出参数：无；返回值：识别结果中的地址，在识别护照时导出的是国籍简码；或者NULL；该方法必须在调用识别方法成功后使用。如果返回NULL,可以通过接口方法BSTR GetLastErrorInfo()获得失败的信息;接口方法：BSTR GetSignDate();功能：获得识别结果中的签发日期，在识别护照时导出的是有效期至 参数：输入/输出参数：无； 返回值：识别结果中的签发日期,在识别护照时导出的是有效期至; 或者 NULL该方法必须在调用识别方法成功后使用。如果返回NULL，可以通过接口方法BSTR GetLastErrorInfo()获得失败的信息;接口方法： BSTR GetVal