并完成读卡任务后调用。
参 数：无
返 回 值：
值
意义
1
正确
其它
错误
注意：如果不再使用已打开的端口，必须使用 CloseComm 函数关闭端口。
4.2. 读二代证相关函数
4.2.1. 卡认证接口
原 型：int Authenticate (void)
说 明：本函数用于发现身份证卡并选择卡。
参 数：无
பைடு நூலகம்
返 回 值：
4. 接口函数说明
4.1. 端口函数
4.1.1. 端口初始化函数
原 型：int InitComm (int iPort) 说 明：本函数用于打开串口或 USB 并检测读卡设备是否就绪。 参 数：iPort：设置串口、USB、USB-HID（免驱动）接口
串口 USB
例如：
1 – 16(十进制) 1： 1(COM1) 2：2(COM2)
参 数： pMsg [out] 无符号字符指针，指向读到的文本信息。需要在调用时 分配内存，字节数不小于 192。函数调用成功后，各字段的文本信息已经转 换为单字节形式，并表示为字符串格式。字段意义及偏移值如下所示：
项目
长度（字节）
说明
姓名
31
汉字
性别
3
汉字
民族
10
汉字
出生日期
9
CCYYMMDD
住址
项目
长度（字节）
说明
姓名
31
汉字
性别
3
汉字
民族
10
汉字
出生日期
9
CCYYMMDD
住址
71
汉字和数字
公民身份号码
19
数字
签发机关
31
汉字
有效期起始日期
9
CCYYMMDD
有效期截止日期
9
CCYYMMDD
有效期为长期的表示为汉
字“长期”
Len [out] 整数， 返回总字符长度，可以给空值（NULL）。
返 回 值： 值 1 0
值
意义
1
正确
0
错误
4
目录不存在
原 型 3：int ReadBaseInfos( char * Name, char * Gender, char * Folk, char *BirthDay, char * Code, char * Address,char *Agency, char * ExpireStart， char* ExpireEnd)
Code [out] 字符型指针，指向身份证号码信息。需要在调用时分配 内存，字节数不小 19。
Address [out] 字符型指针，指向地址信息。需要在调用时分配内存， 字节数不小 71。
Agency [out] 字符型指针，指向签证机关信息。需要在调用时分配内 存，字节数不小 31。
ExpireStart [out] 字符型指针，指向有效期起始日期信息。需要在调 用时分配内存，字节数不小 9, 格式为：CCYYMMDD。
Windows XP。 至少 32 兆内存（32M RAM or Larger）。
-1-
至少 10 兆空闲硬盘空间（10M Free Hard Disk Space or Larger）。 至少一个空闲普通串口或 USB 口（视用户需求而定）。
3. 接口文件说明
接口文件包括： Dewlt.dll sdtapi.dll JpgDll.dll SavePhoto.dll sdtapi.h
返 回 值： 值 1 0 4
意义 正确 错误 目录不存在
原 型 5：int ReadBaseMsgW( unsigned char * pMsg, int * len)； 说 明：本函数用于读取卡中基本信息，包括文字信息与图像信息。 文字信息未解析，文字信息采用 GB13000 的 UCS-2 进行存储，图象信息被 解码后存为文件 photo.bmp（在当前工作目录下）。 参 数： pMsg [out] 无符号字符指针，指向读到的文本信息。需要在调用时 分配内存，字节数不小于 256。偏移值如下所示：
适用开发语言： Visual C++ C++ Builder Visual Basic Delphi PowerBuilder
相关动态联接库 相关动态联接库 相关动态联接库 相关动态联接库 相关动态联接库头文件
5.0 及以后版本 5.0 及以后版本 5.0 及以后版本 3.0 及以后版本 5.0 及以后版本
-6-
分配内存，字节数不小 3。 Folk [out] 字符型指针，指向民族信息。需要在调用时分配内存，
字节数不小 10。 BirthDay [out] 字符型指针，指向出生日期信息。需要在调用时分配内
存，字节数不小 9，前四位为出生年，第 5 位到第 6 位是出生月，后两位是 出生日，格式为：CCYYMMDD。
71
汉字和数字
公民身份号码
19
签发机关
31
数字 汉字
有效期起始日期
9
CCYYMMDD
有效期截止日期
9
CCYYMMDD
有效期为长期的表示为汉
字“长期”
Len [out] 整数， 返回总字符长度，可以给空值（NULL）。 directory [in] 字符指针,表示照片存储路径，路径最后有无“\”均 可；可以给空值（NULL），表示照片存储在当前目录中，此时函数效果同 ReadBaseMsg。 返 回 值：
说 明：本函数用于读取卡中基本信息，包括文字信息与图像信息。 文字信息以字符串格式输出。照片信息被解码后存为文件 photo.bmp，身份 证正面图片 1.jpg，身份证反面图片 2.jpg（在当前工作目录下）。
参 数： Name [out] 字符型指针，指向姓名信息。需要在调用时分配内存，
-5-
字节数不小 31。 Gender [out] 字符型指针，指向性别信息（男或者女）。需要在调用时
ExpireEnd [out] 字符型指针，指向有效期截至日期信息。需要在调 用时分配内存，字节数不小 9，格式为：CCYYMMDD，有效期为长期的表 示为汉字“长期”。
directory [in] 字符指针,表示照片存储路径，路径最后有无“\” 均可；可以给空值（NULL），表示照片存储在当前目录中，此时函数效果 同 ReadBaseInfos。
1001
1001
-2-
返 回 值：
值 1
其它
意义 正确 错误
注：如果读卡机具连接的端口是确定的，可以直接使用相应端口号调用 本函数。否则，可以采用循环查找的方式调用本函数。
4.1.2. 端口关闭接口
原 型：int CloseComm(void)
说 明：本函数用于关闭已打开的端口，一般在调用 InitComm 成功
1. 概述
精伦电子开发的二代身份证读卡系列机具适用于相关行业的联机型应 用。产品提供了完善的二次软件开发接口（API）。本手册对开发接口的文件 组成、函数定义格式、调用方法及返回值等进行详细的说明。
本通用开发包支持的设备型号如下： 1、 iDR200（串口和 USB 口）。 2、 iDR320（必须进入“同步应用”模式）。 3、 iDR400-1（必须进入“同步”模式）。 4、 iDR210（USB-HID 免驱动接口）。 5、 iDR210（串口）。
说明 汉字 代码 代码 年月日：YYYYMMDD 汉字和数字 数字 汉字
-8-
有效期起始日期 有效期截止日期
最新住址
16
年月日：YYYYMMDD
16
年月日：YYYYMMDD
有效期为长期时存储“长
期”
70
汉字和数字
Len [out] 整数， 返回基本信息长度。 directory [in] 字符指针,表示照片存储路径，路径最后有无“\” 均可；可以给空值（NULL），表示照片存储在当前目录中，此时函数效果 同 ReadBaseMsgW。
值
意义
1
正确
0
错误
-3-
注：认证卡时，需要将身份证放置于读卡机具上方并做稍许时间的停留。 如果函数返回错误表示没有发现卡或者卡停留时间太短。
4.2.2. 读卡信息接口
原 型：int ReadBaseMsg( unsigned char * pMsg, int * len)； 说 明：本函数用于读取卡中基本信息，包括文字信息与图像信息。 文字信息已经分段解析，输出格式为单字节,且每一字段信息已经被表示为 字符串。图象信息被解码后存为文件 photo.bmp（在当前工作目录下）。 参 数： pMsg [out] 无符号字符指针，指向读到的文本信息。需要在调用时 分配内存，字节数不小于 192。函数调用成功后，各字段的文本信息已经转 换为单字节形式，并表示为字符串格式。字段意义及偏移值如下所示：
项目
长度（字节）
说明
-7-
姓名 性别 民族 出生 住址 公民身份号码 签发机关 有效期起始日期 有效期截止日期
最新住址
30
汉字
2
代码
4
代码
16
年月日：YYYYMMDD
70
汉字和数字
36
数字
30
汉字
16
年月日：YYYYMMDD
16
年月日：YYYYMMDD
有效期为长期时存储“长
期”
70
汉字和数字
Len [out] 整数， 返回基本信息长度。
说 明：本函数用于读取卡中基本信息，包括文字信息与图像信息。 文字信息以字符串格式输出。图象信息被解码后存为照片 photo.bmp 和 photo.jpg，身份证正面图片 1.jpg，身份证反面图片 2.jpg（在 directory 指定 目录下）。