《社會(huì)保障(個(gè)人)卡規(guī)范》終端規(guī)范補(bǔ)充說明

1、社會(huì)保障（個(gè)人）卡規(guī)范終端規(guī)范補(bǔ)充說明第三部分：終端規(guī)范引言（ P121）最后一行“本規(guī)范附錄A、 B、 C 由各地參照?qǐng)?zhí)行”，修改為：本規(guī)范附錄B 與規(guī)范正文具有同等的效力。1 適用范圍（ P121）修改為：本規(guī)范適用于支持社會(huì)保障（個(gè)人）卡規(guī)范所規(guī)定的勞動(dòng)和社會(huì)保障應(yīng)用的專用終端以及其他類似的終端設(shè)備。其中的“終端功能”、 “黑名單管理”不適用于讀卡器。其使用對(duì)象主要是與社會(huì)保障卡應(yīng)用相關(guān)的終端設(shè)計(jì)、制造、管理以及應(yīng)用系統(tǒng)的研制、開發(fā)、集成和維護(hù)等組織機(jī)構(gòu)。5.1.1.4 ICC連接器的配置和要求（ P124）最后一行“接口設(shè)備所使用的應(yīng)用 ICC 連接器應(yīng)具有至少30 萬次 的插拔壽命”

2、修改為：接口設(shè)備所使用的應(yīng)用ICC連接器應(yīng)具有至少10萬次的插拔壽命。5.1.2.3 編程電壓（ P125）修改為：不要求終端產(chǎn)生編程電壓VPP（見5.1.1.3 ）。5.1.4 終端與接口設(shè)備之間的數(shù)據(jù)交換（P128）本節(jié)原標(biāo)題和內(nèi)容全部刪除，修改為：5.1.4 終端與 IC 卡之間的數(shù)據(jù)交換終端設(shè)備應(yīng)能夠接收IC 卡一次返回 256 字節(jié)的數(shù)據(jù)及后續(xù)的狀態(tài)碼。附錄 A（ P132）本節(jié)刪除。附錄 B（ P136）本節(jié)全文修改為：附 錄 B（執(zhí)行的附錄）高級(jí)應(yīng)用編程接口本附錄描述了讀卡器的高級(jí)應(yīng)用編程接口：高級(jí)應(yīng)用編程接口是提供給終端上的應(yīng)用程序用來與讀卡器進(jìn)行交互操作的函數(shù)集。高級(jí)應(yīng)用編程

3、接口的具體表現(xiàn)形式必須包括：a. 可以在 32 位 Windows 環(huán)境下 ( Windows95/98/ME, Windows NT/2000/XP 等)運(yùn)行的動(dòng)態(tài)鏈接庫(kù)(SSSE32.DLL) ；b. 可以在 16 位 Windows 環(huán)境下( Windows3.1 等)運(yùn)行的動(dòng)態(tài)鏈接庫(kù)(SSSE16.DLL) ；c. 可以在DO科境下運(yùn)行的 C語言(MSC或Borland C)函數(shù)庫(kù)(SSSE16.LIB)；d. 可以在DO科境下運(yùn)行的 Foxpro函數(shù)庫(kù)(SSSE16.PLB)。高級(jí)應(yīng)用編程接口的具體表現(xiàn)形式也可以包括：a.可以在Unix環(huán)境下運(yùn)行的C語言函數(shù)庫(kù)；b.可以在基于特定硬件

4、平臺(tái)上的C語言函數(shù)庫(kù)上述所有高級(jí)應(yīng)用編程接口應(yīng)具有本規(guī)范所規(guī)定的統(tǒng)一的庫(kù)名、函數(shù)名、參數(shù)類型和順序。應(yīng)用開發(fā)者或用戶在對(duì)讀卡器編程時(shí)，可使用相應(yīng)的庫(kù)名和函數(shù)名。注：在以下的描述中，分別使用C語言和Foxpro語言風(fēng)格來說明高級(jí)應(yīng)用編程接口中的函B1 C 語言函數(shù)81.1 “打開設(shè)備”函數(shù)函數(shù)：long ICC_Reader_Open (char* dev_Name)功能：該函數(shù)通知終端操作系統(tǒng)打開與讀卡器所對(duì)應(yīng)的終端設(shè)備端口， 以便兩者建立通信的邏輯關(guān)系。參數(shù)說明：dev_Name：設(shè)備名稱。取值范圍” AUTO、 COMn、 USBn、 LPTn“，其中“ n” 的取值范圍為 19 。返回值

5、：若正常，返回值為不小于0 的設(shè)備句柄；反之返回值為狀態(tài)碼，其含義見B1.8 。注：對(duì)16位Windows環(huán)境下運(yùn)行的動(dòng)態(tài)鏈接庫(kù)、DOS境下運(yùn)行的靜態(tài)函數(shù)庫(kù)返回的設(shè)備句柄，其含義均不同于32 位 Windows 環(huán)境下動(dòng)態(tài)鏈接庫(kù)返回的設(shè)備句柄，僅為區(qū)分設(shè)備之用。81.2 “關(guān)閉設(shè)備”函數(shù)函數(shù)：long ICC_Reader_Close (long ReaderHandle)該函數(shù)通知操作系統(tǒng)關(guān)閉所指定的設(shè)備。參數(shù)說明：ReaderHandle ：設(shè)備句柄。返回值：返回值含義見B1.8 。81.3 “卡上電”或“熱復(fù)位“函數(shù)函數(shù)：long ICC_Reader_PowerOn (long Rea

6、derHandle ， unsigned char ICC_Slot_No ， unsigned char* Response)功能：該函數(shù)要求讀卡器對(duì)ICC 進(jìn)行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動(dòng)一個(gè)熱復(fù)位。參數(shù)說明：1. ReaderHandle ：設(shè)備句柄；2. ICC_Slot_No : ICC連接器號(hào)；用戶卡連接器號(hào)0x0n , SAM卡連接器號(hào)0x1n,其中“ n的取值范圍為 1F ；3. Response ：指向存放響應(yīng)數(shù)據(jù)的存儲(chǔ)區(qū)的指針。返回值：如果對(duì) ICC 復(fù)位成功，則在 Response 的存儲(chǔ)區(qū)中返回 ICC 的復(fù)位應(yīng)答字節(jié)，返回值為存儲(chǔ)區(qū)中的字節(jié)數(shù)；返回值小于0 為狀態(tài)

7、碼，其含義見 B1.8 。81.4 “卡下電”函數(shù)函數(shù)：long ICC_Reader_PowerOff (long ReaderHandle ， unsigned char ICC_Slot_No)功能：該函數(shù)要求讀卡器撤銷與ICC 之間的電氣連接。參數(shù)說明：1. ReaderHandle ：設(shè)備句柄；2. ICC_Slot_No ： ICC 連接器號(hào)。返回值：如果該函數(shù)成功執(zhí)行，則返回值為 0；返回值小于0為狀態(tài)碼，其含義見B1.8 。81.5 “獲取卡片狀態(tài)”函數(shù)函數(shù)：long ICC_Reader_GetStatus (long ReaderHandle5unsigned char I

8、CC_Slot_No)功能：查詢有無卡以及卡片當(dāng)前狀態(tài)信息。參數(shù)說明：1. ReaderHandle ：設(shè)備句柄；2. ICC_Slot_No ： ICC 連接器號(hào)。返回值：返回 0 表示有卡且已上電；返回值小于0 為狀態(tài)碼，其含義見B1.8 。B1.6 “應(yīng)用命令”函數(shù)函數(shù)：long ICC_Reader_Application (long ReaderHandle， unsigned char ICC_ Slot _No ， longLenth_of_Command_APDU， unsigned char*Command_APD，U unsigned char* Response_APDU

9、)功能：該函數(shù)用于將符合ISO 7816 中所規(guī)定的基本和特殊功能的行業(yè)間交換用命令發(fā)送給指定的ICC 連接器，并獲取對(duì)應(yīng)的響應(yīng)。參數(shù)說明：1. ReaderHandle ：設(shè)備句柄；2. ICC_Slot_No ： ICC 連接器號(hào)；3. Lenth_of_Command_APDU :其值為 Command_APD所指向緩沖區(qū)中的字節(jié)數(shù)；4. Command_APDU指向存放命令的緩沖區(qū)的指針；5. Response_APDU ：指向存放響應(yīng)數(shù)據(jù)的存儲(chǔ)區(qū)的指針 ( 包括 sw1,sw2) 。返回值：如果函數(shù)執(zhí)行成功，則在Response_APDU的存儲(chǔ)區(qū)中返回響應(yīng)數(shù)據(jù)，函數(shù)返回值為存儲(chǔ)區(qū)中的

10、字節(jié)數(shù)；返回值小于0為狀態(tài)碼，其含義見B1.8, Response_APDU的存儲(chǔ)區(qū)無任何數(shù)據(jù)。B1.7 “取信息”函數(shù)函數(shù)：long ICC_Reader_Libinfo (char* info)功能：該函數(shù)取得當(dāng)前函數(shù)庫(kù)的廠家信息。參數(shù)說明：功能：info :指向存放廠家信息的存儲(chǔ)區(qū)的指針。表- B1.1廠家信息的存儲(chǔ)格式第116字符第1730字符第31、32字符廠家名稱（不足補(bǔ)空格）設(shè)備型號(hào)或系列號(hào)（不足補(bǔ)空格）函數(shù)庫(kù)版本號(hào)返回值：返回值的含義見 B1.8B1.8 函數(shù)返回值表-B1.2高級(jí)編程接口C語言函數(shù)的返回值應(yīng)用編程的標(biāo)識(shí)符返回值含義IFD_OK0執(zhí)行成功IFD_ICC_Type

11、Error-1卡片類型不對(duì)IFD_ICC_NoExist-2無卡IFD_ICC_NoPower-3有卡未上電IFD_ICC_NoResponse-4卡片無應(yīng)答IFD_ConnectError-11讀卡器連接錯(cuò)IFD_UnConnected-12未建立連接（沒有執(zhí)行打開設(shè)備函數(shù)）IFD_BadCommand-13（動(dòng)態(tài)庫(kù)）不支持該命令I(lǐng)FD_ParameterError-14（發(fā)給動(dòng)態(tài)庫(kù)的）命令參數(shù)錯(cuò)IFD_CheckSumError-15信息校驗(yàn)和出錯(cuò)B2 Foxpro 語言函數(shù)注：在以下的描述中，所指字符為ASCII字符B2.1“打開設(shè)備”函數(shù)函數(shù)：ICCR_Open (dev_Name)以

12、便兩者建立通信的邏輯關(guān)該函數(shù)通知終端操作系統(tǒng)打開與讀卡器所對(duì)應(yīng)的終端設(shè)備端口，參數(shù)說明：dev_Name：設(shè)備名稱。取值范圍”AUTO、 COMn、 LPTn“，其中“ n”的取值范圍為19。返回值：返回值為一字符串 , 前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見B2.8 ；若執(zhí)行成功，第3 、 4個(gè)字符為函數(shù)執(zhí)行后返回的設(shè)備句柄R_Handle ，該句柄僅為區(qū)分設(shè)備之用。B2.2 “關(guān)閉設(shè)備”函數(shù)函數(shù)：ICCR_Close (R_Handle)功能：該函數(shù)通知操作系統(tǒng)關(guān)閉所指定的設(shè)備。參數(shù)說明：R_Handle ：設(shè)備句柄。返回值：返回值為兩個(gè)字符的狀態(tài)碼，其含義見B2.8 。B2.3 “卡上電”

13、或“熱復(fù)位“函數(shù)函數(shù)：ICCR_Pon (R_Handle ， ICCSlotNo)功能：該函數(shù)要求讀卡器對(duì)ICC 進(jìn)行冷復(fù)位，若冷復(fù)位失敗讀卡器應(yīng)啟動(dòng)一個(gè)熱復(fù)位。參數(shù)說明：1. R_Handle ：設(shè)備句柄；2. ICCSlotNo : ICC連接器號(hào)；用戶卡連接器號(hào)0x0n , SAM卡連接器號(hào)0x1n,其中“ n”的取值范圍為 1F 。返回值：返回值為一字符串 , 前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見B2.8 ；若執(zhí)行成功，第3 、 4兩個(gè)字符為復(fù)位應(yīng)答中的字節(jié)數(shù)(十六進(jìn)制)，從第五字符起為 ICC 的復(fù)位應(yīng)答字符 (字符個(gè)數(shù) 為字節(jié)數(shù)的 2 倍)。B2.4“卡下電”函數(shù)函數(shù)：ICCR_

14、Poff (R_Handle功能：ICCSlotNo)該函數(shù)要求讀卡器撤銷與ICC 之間的電氣連接。參數(shù)說明：1. R_Handle ：設(shè)備句柄；2. ICCSlotNo : ICC 連接器號(hào)。返回值：返回值為兩個(gè)字符的狀態(tài)碼，其含義見B2.8 。82.5 “獲取卡片狀態(tài)”函數(shù)函數(shù)：ICCR_GetS (R_Handle ， ICCSlotNo)功能：查詢有無卡以及卡片當(dāng)前狀態(tài)信息。參數(shù)說明：1. R_Handle ：設(shè)備句柄；2. ICCSlotNo ： ICC 連接器號(hào)。返回值：返回值為兩個(gè)字符的狀態(tài)碼，”00”表示有卡且已上電，其他含義見B2.8 。82.6 “應(yīng)用命令”函數(shù)函數(shù)：ICC

15、R_App (R_Handle ， ICCSlotNo ， ComAPDU)功能：該函數(shù)用于將符合ISO 7816 中所規(guī)定的基本和特殊功能的行業(yè)間交換用命令發(fā)送給指定的ICC 連接器，并獲取對(duì)應(yīng)的響應(yīng)。參數(shù)說明：1. R_Handle ：設(shè)備句柄；2. ICCSlotNo ： ICC 連接器號(hào)；3. ComAPDU:命令字符串，每?jī)勺址硎景l(fā)送命令的一字節(jié)。返回值：返回值為一字符串 , 前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見B2.8 ； 若執(zhí)行成功， 第 3、 4、7 字符起為響應(yīng)數(shù)據(jù)字符(字符個(gè)數(shù)為字節(jié)5、 6 字符為響應(yīng)數(shù)據(jù)的字節(jié)數(shù)(十六進(jìn)制)，從第數(shù)的 2 倍)。82.7 “取信息”函數(shù)函數(shù)：ICCR_Linfo（）功能：該函數(shù)取得當(dāng)前函數(shù)庫(kù)的廠家信息。參數(shù)說明：返回值：返回值為一字符串，前兩個(gè)字符為函數(shù)執(zhí)行狀態(tài)碼，其含義見B2.8 ;若執(zhí)行成功，從第 3字符起為廠家信息字符串。表-B2.1廠家信息的存儲(chǔ)格式第116字符第1730字符第31、32字符廠家名稱（不足補(bǔ)空格）設(shè)備型號(hào)或系列號(hào)（不足補(bǔ)空格）函數(shù)庫(kù)版本號(hào)82.8 函數(shù)返回值表-B2.2高級(jí)編程接口 Foxpro函數(shù)的返回值應(yīng)用編程的標(biāo)識(shí)符返回值含