出入境證件識(shí)讀客戶(hù)端SDK接口規(guī)范V1.5

出入境證件識(shí)讀客戶(hù)端識(shí)讀應(yīng)用接口前言本文檔用于出入境證件識(shí)讀系統(tǒng)客戶(hù)端證件數(shù)據(jù)識(shí)讀，證件種類(lèi)包括電子護(hù)照、電子內(nèi)地居民往來(lái)港澳通行證、電子港澳居民來(lái)往內(nèi)地通行證、電子大陸居民往來(lái)臺(tái)灣通行證臺(tái)胞證以及電子臺(tái)灣居民來(lái)往大陸通行證五大類(lèi)。接口方式2.1接口名稱(chēng)NIA_ETDA.dll2.2配置文件配置文件說(shuō)明config_14.xml、config_21.xml、app.conf主動(dòng)態(tài)庫(kù)配置文件“Windows\System32\drivers\etc”下出入境證件數(shù)據(jù)結(jié)構(gòu)structGAT_PersonInfo{intiDocTypeLen; //證件類(lèi)型長(zhǎng)度 intiDocNoLen; //證件號(hào)碼長(zhǎng)度 intiChnNameLen; //中文姓名長(zhǎng)度 intiEngNameLen; //英文姓名長(zhǎng)度（全拼音姓名，分隔符用空格替換，如有兩個(gè)空格變1個(gè)，例如：Xiaopeisen）intiDateLen; //出生日期長(zhǎng)度intiSexLen; //性別長(zhǎng)度：1-男性intiExpireLen; //有效期長(zhǎng)度：例子intiPicLen; //照片長(zhǎng)度 bytepDocType[4];//證件類(lèi)型：21-往來(lái)港澳通行證、414-電子護(hù)照、511-臺(tái)灣居民來(lái)往大陸通行證、516-港澳居民來(lái)往內(nèi)地通行證、25-大陸居民往來(lái)臺(tái)灣通行證 bytepDocNo[16];//證件號(hào)碼 bytepChnName[64]; //中文姓名 bytepEngName[64]; //英文姓名 bytepDate[16]; //出生日期 bytepSex[2]; //性別 bytepExpire[32];//有效期 bytepPic[20591];//照片};注：該結(jié)構(gòu)體用于讀取電子旅行證件持證人個(gè)人信息，讀取時(shí)需要應(yīng)用系統(tǒng)為該結(jié)構(gòu)體分配內(nèi)存空間，缺省填寫(xiě)0x00。函數(shù)列表序號(hào)函數(shù)名功能描述HYPERLINKgetDllVersion獲取動(dòng)態(tài)庫(kù)版本號(hào)HYPERLINKreadPersonInfo讀電子旅行證件個(gè)人信息（含讀寫(xiě)設(shè)備打開(kāi)、尋卡、讀數(shù)據(jù)以及關(guān)閉讀寫(xiě)設(shè)備）HYPERLINKopenReader打開(kāi)掛接在終端設(shè)備上的讀卡器列表HYPERLINKreadPersonInfoOnly讀電子旅行證件個(gè)人信息（只包含尋卡和讀數(shù)據(jù)，讀寫(xiě)設(shè)備操作需要調(diào)用接口3和5完成）HYPERLINKcloseReader關(guān)閉通過(guò)該讀卡器進(jìn)行出入境證件讀取的對(duì)應(yīng)讀卡器readDocType本地讀取證件類(lèi)型獲取動(dòng)態(tài)庫(kù)版本號(hào)publiclonggetDllVersion(char*pDiscription);【說(shuō)明】本函數(shù)用于取動(dòng)態(tài)庫(kù)版本號(hào)【參數(shù)】pDiscription（輸出參數(shù)）動(dòng)態(tài)庫(kù)版本號(hào),長(zhǎng)度32字節(jié)【結(jié)果】返回0獲取成功其他HYPERLINK錯(cuò)誤讀電子旅行證件個(gè)人信息publiclongreadPersonInfo(boolbGetPic，PersonInfo*pPersonInfo);【說(shuō)明】本函數(shù)用于從證件中讀出個(gè)人信息，包含讀寫(xiě)設(shè)備打開(kāi)、尋卡、讀數(shù)據(jù)以及關(guān)閉讀寫(xiě)設(shè)備操作，用戶(hù)不用關(guān)心讀寫(xiě)設(shè)備操作【參數(shù)】bGetPic; (輸入?yún)?shù))是否讀取照片pPersonInfo(輸出參數(shù))個(gè)人基本信息內(nèi)容【結(jié)果】返回0正確其他HYPERLINK錯(cuò)誤打開(kāi)讀寫(xiě)設(shè)備列表publiclongOpenReader(char*pReader);【說(shuō)明】本函數(shù)用于打開(kāi)終端設(shè)備的讀寫(xiě)設(shè)備列表【參數(shù)】pReader(輸出參數(shù))終端設(shè)備掛接讀寫(xiě)設(shè)備列表（滿(mǎn)足PC/SC協(xié)議要求）【結(jié)果】返回0正確其他HYPERLINK錯(cuò)誤只讀電子旅行證件個(gè)人信息publiclongreadPersonInfoOnly(boolbGetPic，char*pReader,PersonInfo*pPersonInfo);【說(shuō)明】本函數(shù)用于從證件中讀出個(gè)人信息，只包含尋卡和讀數(shù)據(jù)，讀寫(xiě)設(shè)備操作需要調(diào)用接口3和5完成【參數(shù)】bGetPic; (輸入?yún)?shù))是否讀取照片pReader(輸入?yún)?shù))終端設(shè)備掛接讀寫(xiě)設(shè)備列表pPersonInfo(輸出參數(shù))個(gè)人基本信息內(nèi)容【結(jié)果】返回0正確其他HYPERLINK錯(cuò)誤關(guān)閉對(duì)應(yīng)讀寫(xiě)設(shè)備publiclongcloseReader(char*pReader);【說(shuō)明】本函數(shù)用于關(guān)閉指定名稱(chēng)讀寫(xiě)設(shè)備【參數(shù)】pReader(輸入?yún)?shù))要關(guān)閉的讀寫(xiě)設(shè)備名稱(chēng)【結(jié)果】返回0正確其他HYPERLINK錯(cuò)誤讀證件類(lèi)型publiclongreadDocType(c