出入境证件识读客户端SDK接口规范V1.5

出入境证件识读客户端识读应用接口前言本文档用于出入境证件识读系统客户端证件数据识读，证件种类包括电子护照、电子内地居民往来港澳通行证、电子港澳居民来往内地通行证、电子大陆居民往来台湾通行证台胞证以及电子台湾居民来往大陆通行证五大类。接口方式2.1接口名称NIA_ETDA.dll2.2配置文件配置文件说明config_14.xml、config_21.xml、app.conf主动态库配置文件“Windows\System32\drivers\etc”下出入境证件数据结构structGAT_PersonInfo{intiDocTypeLen; //证件类型长度 intiDocNoLen; //证件号码长度 intiChnNameLen; //中文姓名长度 intiEngNameLen; //英文姓名长度（全拼音姓名，分隔符用空格替换，如有两个空格变1个，例如：Xiaopeisen）intiDateLen; //出生日期长度intiSexLen; //性别长度：1-男性intiExpireLen; //有效期长度：例子intiPicLen; //照片长度 bytepDocType[4];//证件类型：21-往来港澳通行证、414-电子护照、511-台湾居民来往大陆通行证、516-港澳居民来往内地通行证、25-大陆居民往来台湾通行证 bytepDocNo[16];//证件号码 bytepChnName[64]; //中文姓名 bytepEngName[64]; //英文姓名 bytepDate[16]; //出生日期 bytepSex[2]; //性别 bytepExpire[32];//有效期 bytepPic[20591];//照片};注：该结构体用于读取电子旅行证件持证人个人信息，读取时需要应用系统为该结构体分配内存空间，缺省填写0x00。函数列表序号函数名功能描述HYPERLINKgetDllVersion获取动态库版本号HYPERLINKreadPersonInfo读电子旅行证件个人信息（含读写设备打开、寻卡、读数据以及关闭读写设备）HYPERLINKopenReader打开挂接在终端设备上的读卡器列表HYPERLINKreadPersonInfoOnly读电子旅行证件个人信息（只包含寻卡和读数据，读写设备操作需要调用接口3和5完成）HYPERLINKcloseReader关闭通过该读卡器进行出入境证件读取的对应读卡器readDocType本地读取证件类型获取动态库版本号publiclonggetDllVersion(char*pDiscription);【说明】本函数用于取动态库版本号【参数】pDiscription（输出参数）动态库版本号,长度32字节【结果】返回0获取成功其他HYPERLINK错误读电子旅行证件个人信息publiclongreadPersonInfo(boolbGetPic，PersonInfo*pPersonInfo);【说明】本函数用于从证件中读出个人信息，包含读写设备打开、寻卡、读数据以及关闭读写设备操作，用户不用关心读写设备操作【参数】bGetPic; (输入参数)是否读取照片pPersonInfo(输出参数)个人基本信息内容【结果】返回0正确其他HYPERLINK错误打开读写设备列表publiclongOpenReader(char*pReader);【说明】本函数用于打开终端设备的读写设备列表【参数】pReader(输出参数)终端设备挂接读写设备列表（满足PC/SC协议要求）【结果】返回0正确其他HYPERLINK错误只读电子旅行证件个人信息publiclongreadPersonInfoOnly(boolbGetPic，char*pReader,PersonInfo*pPersonInfo);【说明】本函数用于从证件中读出个人信息，只包含寻卡和读数据，读写设备操作需要调用接口3和5完成【参数】bGetPic; (输入参数)是否读取照片pReader(输入参数)终端设备挂接读写设备列表pPersonInfo(输出参数)个人基本信息内容【结果】返回0正确其他HYPERLINK错误关闭对应读写设备publiclongcloseReader(char*pReader);【说明】本函数用于关闭指定名称读写设备【参数】pReader(输入参数)要关闭的读写设备名称【结果】返回0正确其他HYPERLINK错误读证件类型publiclongreadDocType(c