神思SS728M05终端API接口函数库用户手册V16

1、SS728M05 设备驱动接口函数库 用 户 手 册 V1.6 拟 制： 陈龙 日期：2014-12-26 审 核： 日期： 标准化： 日期： 批 准： 日期： 山 东 神 思 电 子 文档编号 归档编号 发布状态 文档版本 用户手册 第 2 页 共 77 页 目 录 SS728M05 设备驱动接口函数库设备驱动接口函数库.1 用用 户户 手手 册册.1 V1.6.1 目目 录录.2 1终端简介终端简介.8 1.1主要功能.8 1.2主要技术指标.8 2接口库概述接口库概述.9 2.1适用范围.9 2.2说明.9 3接口函数接口函数.10 3.1函数返回值.10 3.1.1通用返回值.10 3

2、.1.2居民健康卡（兼容山东保健证）错误代码.11 3.2基本接口函数.12 3.2.1SS728M05_SDK（SS728M05 基本操作接口）.12 3.2.1.1基本函数.12 3.2.1.1.1ICC_Reader_Open .12 3.2.1.1.2ICC_Reader_Close.12 3.2.1.1.3ICC_Reader_Reset.12 3.2.1.1.4ICC_Reader_PowerOff .13 3.2.1.1.5ICC_Reader_Application.13 3.2.1.1.6ICC_Reader_GetLastError.13 3.2.1.1.7ICC_Read

3、er_Version .14 3.2.1.1.8SS_Reader_Reset .14 3.2.1.1.9SS_Reader_Reset_bBeep.15 3.2.1.1.10SS_Reader_PowerOff.15 3.2.1.1.11SS_Reader_Application.16 3.2.1.1.12SS_Reader_GetLastError.16 3.2.1.1.13SS_Reader_Version.16 3.2.1.1.14SS_Reader_GetVersionID.17 3.2.1.1.15SS_Reader_GetUserInfo .17 3.2.1.1.16SS_Rea

4、der_UpdateUserInfo.17 3.2.1.1.17SS_Reader_AutoRecognition.17 3.2.1.1.18SS_Reader_AutoFindCard.18 3.2.1.1.19ss_dev_beep.18 3.2.1.1.20ss_dev_led .18 3.2.1.2居民二代身份证函数.18 用户手册 第 3 页 共 77 页 3.2.1.2.1ss_id_ResetID2Card.18 3.2.1.2.2ss_id_read_card.19 3.2.1.2.3ss_id_query_name.19 3.2.1.2.4ss_id_query_sex .1

5、9 3.2.1.2.5ss_id_query_sexL.19 3.2.1.2.6ss_id_query_folk .19 3.2.1.2.7ss_id_query_folkL.20 3.2.1.2.8ss_id_query_birth.20 3.2.1.2.9ss_id_query_address.20 3.2.1.2.10ss_id_query_number.20 3.2.1.2.11ss_id_query_organ.21 3.2.1.2.12ss_id_query_termbegin.21 3.2.1.2.13ss_id_query_termend.21 3.2.1.2.14ss_id_

6、query_photo_data.21 3.2.1.2.15ss_id_query_photo_file .21 3.2.1.2.16ss_id_query_newaddress.22 3.2.1.2.17ss_id_query_IDBaseInfo_text.22 3.2.1.2.18ss_id_GetSAMno .22 3.2.1.2.19ss_id_GetSAMStatus.23 3.2.1.2.20ss_id_GetFPMsg.23 3.2.1.3M1 卡操作函数.23 3.2.1.3.1ss_CardMifare_Reset .23 3.2.1.3.2ss_CardMifare_Au

7、thentication.23 3.2.1.3.3ss_CardMifare_ReadBlock.24 3.2.1.3.4ss_CardMifare_WriteBlock.24 3.2.1.3.5ss_CardMifare_Increment.24 3.2.1.3.6ss_CardMifare_Decrement.24 3.2.1.3.7ss_CardMifare_Copy.24 3.2.1.3.8ss_CardMifare_GetUID .25 3.2.1.4标准社保卡操作作函数.25 3.2.1.4.1ss_rf_sb_FindCard.25 3.2.1.4.2ss_rf_sb_ReadC

8、ardIssuers.25 3.2.1.4.3ss_rf_sb_ReadCardholder.26 3.2.1.4.4ss_rf_sb_ReadFingerprint.26 3.2.1.5济南社保卡操作函数.26 3.2.1.5.1ss_jn_sb_FindCard.26 3.2.1.5.2ss_jn_sb_QuerryCardNumber.26 3.2.1.64428 卡操作函数.27 3.2.1.6.1ss_sle_reset_card.27 3.2.1.6.2ss_sle4428_read_card.27 3.2.1.7磁条卡操作作函数.27 3.2.1.7.1SS_CT_ReadInf

9、o.27 3.2.1.7.2SS_CT_ReadInfo_.28 3.2.1.8居民健康卡基本函数(兼容山东保健证).28 3.2.1.8.1ss_reader_open.28 用户手册 第 4 页 共 77 页 3.2.1.8.2ss_reader_close.29 3.2.1.8.3ss_rf_yl_cpu_find_card.29 3.2.1.8.4ss_lib_version.29 3.2.1.8.5ss_rf_yl_cpu_find_cardB .29 3.2.1.8.6ss_rf_cpu_yl_read_cardInfo.29 3.2.1.8.7ss_rf_cpu_yl_write

10、_cardInfo.29 3.2.1.8.8ss_rf_yl_cpu_read_issuingOrg.30 3.2.1.8.9ss_rf_yl_cpu_write_issuingOrg.30 3.2.1.8.10ss_rf_yl_cpu_read_demographicInfo1.30 3.2.1.8.11ss_rf_yl_cpu_write_demographicInfo1.30 3.2.1.8.12ss_rf_yl_cpu_read_hospital.31 3.2.1.8.13ss_rf_yl_cpu_write_hospital.31 3.2.1.8.14ss_rf_cpu_yl_rea

11、d_photo .31 3.2.1.8.15ss_rf_cpu_yl_write_photo.31 3.2.1.8.16ss_rf_yl_cpu_read_address.32 3.2.1.8.17ss_rf_yl_cpu_write_address.32 3.2.1.8.18ss_rf_yl_cpu_read_linkman .32 3.2.1.8.19ss_rf_yl_cpu_write_linkman.32 3.2.1.8.20ss_rf_yl_cpu_read_demographicInfo2.33 3.2.1.8.21ss_rf_yl_cpu_write_demographicInf

12、o2.33 3.2.1.8.22ss_rf_yl_cpu_read_idcardInfo.33 3.2.1.8.23ss_rf_yl_cpu_write_idcardInfo.33 3.2.1.8.24ss_rf_yl_cpu_read_illNum.34 3.2.1.8.25ss_rf_yl_cpu_write_illNum.34 3.2.1.8.26ss_rf_yl_cpu_read_BiometricIdentifier.34 3.2.1.8.27ss_rf_yl_cpu_write_BiometricIdentifier .34 3.2.1.8.28ss_rf_yl_cpu_read_

13、SpecialIdentifier.35 3.2.1.8.29ss_rf_yl_cpu_write_SpecialIdentifier.35 3.2.1.8.30ss_rf_yl_cpu_read_AllergicReaction .35 3.2.1.8.31ss_rf_yl_cpu_write_AllergicReaction.35 3.2.1.8.32ss_rf_yl_cpu_read_Immunization.36 3.2.1.8.33ss_rf_yl_cpu_write_Immunization.36 3.2.1.8.34ss_rf_yl_cpu_read_HospitalEffect

14、iveSign.36 3.2.1.8.35ss_rf_yl_cpu_write_HospitalEffectiveSign.36 3.2.1.8.36ss_rf_yl_cpu_RewriteRecord_HospitalEffectiveSign.37 3.2.1.8.37ss_rf_yl_cpu_EraseRecord_HospitalEffectiveSign .37 3.2.1.8.38ss_rf_yl_cpu_read_OutpatientServiceEffectiveSign.37 3.2.1.8.39ss_rf_yl_cpu_write_OutpatientServiceEffe

15、ctiveSign .37 3.2.1.8.40ss_rf_yl_cpu_RewriteRecord_OutpatientServiceEffectiveSign .38 3.2.1.8.41ss_rf_yl_cpu_EraseRecord_OutpatientServiceEffectiveSign.38 3.2.1.8.42ss_rf_cpu_yl_read_HospitalInformation1.38 3.2.1.8.43ss_rf_cpu_yl_write_HospitalInformation1.38 3.2.1.8.44ss_rf_cpu_yl_read_HospitalInfo

16、rmation2.39 3.2.1.8.45ss_rf_cpu_yl_write_HospitalInformation2.39 3.2.1.8.46ss_rf_cpu_yl_read_OutpatientServiceInformation1.39 用户手册 第 5 页 共 77 页 3.2.1.8.47ss_rf_cpu_yl_write_OutpatientServiceInformation1 .39 3.2.1.8.48ss_rf_cpu_yl_read_OutpatientServiceInformation2.40 3.2.1.8.49ss_rf_cpu_yl_write_Out

17、patientServiceInformation2 .40 3.2.1.8.50ss_rf_cpu_yl_read_FingerprintFile .40 3.2.1.8.51ss_rf_cpu_yl_write_FingerprintFile.41 3.2.1.8.52ss_rf_cpu_yl_GetCardUid.41 3.2.1.8.53ss_rf_cpu_yl_read_HospitalInformation3.41 3.2.1.8.54ss_rf_cpu_yl_write_HospitalInformation3.41 3.2.1.8.55ss_rf_cpu_yl_read_Out

18、patientServiceInformation3.42 3.2.1.8.56ss_rf_cpu_yl_write_OutpatientServiceInformation3 .42 3.2.1.8.57ss_rf_cpu_yl_read_OutpatientServiceInformation4.42 3.2.1.8.58ss_rf_cpu_yl_write_OutpatientServiceInformation4 .42 3.2.1.8.59ss_rf_cpu_yl_read_OutpatientExpenses.43 3.2.1.8.60ss_rf_cpu_yl_write_Outp

19、atientExpenses.43 3.2.1.8.61ss_rf_cpu_yl_AppcationLock_ddf1.43 3.2.1.8.62ss_rf_cpu_yl_AppcationUnLock_ddf1 .43 3.2.1.8.63ss_rf_cpu_yl_AppcationLock_df01.44 3.2.1.8.64ss_rf_cpu_yl_AppcationUnLock_df01 .44 3.2.1.8.65ss_rf_cpu_yl_AppcationLock_df02.44 3.2.1.8.66ss_rf_cpu_yl_AppcationUnLock_df02 .44 3.2

20、.1.8.67ss_rf_cpu_yl_AppcationLock_df03.44 3.2.1.8.68ss_rf_cpu_yl_AppcationUnLock_df03 .45 3.2.1.8.69ss_rf_cpu_yl_CardLock .45 3.2.1.8.70ss_rf_cpu_yl_read_PayInfoFile.45 3.2.1.8.71ss_rf_cpu_yl_write_PayInfoFile .45 3.2.1.8.72ss_rf_VerifyPINSAM1.45 3.2.1.8.73ss_rf_ResetSAM1AndVerifyPIN.46 3.2.1.8.74ss

21、_rf_cpu_yl_read_Binaryphoto.46 3.2.1.8.75ss_rf_cpu_yl_write_Binaryphoto.46 3.2.1.8.76ss_rf_cup_yl_GetCardVersion.46 3.2.1.8.77ss_rf_SAM_Reset.46 3.2.1.8.78ss_rf_SAM_VerifyPIN.47 3.2.1.8.79ss_rf_SAM_ChangePIN.47 3.2.1.8.80ss_rf_SAM_Public .47 3.2.1.8.81ss_rf_SAM_Terminal.47 3.2.1.8.82ss_rf_SAM_Public

22、App.48 3.2.1.8.83ss_rf_SAM_OrgCertificate.48 3.2.1.8.84ss_rf_SAM_Certificate.48 3.2.1.8.85ss_rf_SAM_SM3Digest .48 3.2.1.8.86ss_rf_SAM_SM2SignHash .49 3.2.1.9居民健康卡高级函数.49 3.2.1.9.1SS_WSB_OpenDevice.49 3.2.1.9.2SS_WSB_CloseDevice.49 3.2.1.9.3SS_WSB_PowerOn.50 3.2.1.9.4SS_DC_ PowerOff .50 用户手册 第 6 页 共

23、77 页 3.2.1.9.5SS_DC_SetSpacer.50 3.2.1.9.6SS_WSB_SendAPDU.50 3.2.1.9.7SS_DC_Get_Version.51 3.2.1.9.8SS_WSB_VerifyPIN.51 3.2.1.9.9SS_DC_ChangePIN .51 3.2.1.9.10SS_DC_RSAMPublic.52 3.2.1.9.11SS_DC_RSAMTerminal .52 3.2.1.9.12SS_DC_RSAMPublicApp.52 3.2.1.9.13SS_DC_RSAMOrgCertificate.52 3.2.1.9.14SS_DC_R

24、SAMCertificate.53 3.2.1.9.15SS_WSB_RDDF1EF05.53 3.2.1.9.16SS_WSB_RDDF1EF06.53 3.2.1.9.17SS_WSB_RDDF1EF07.54 3.2.1.9.18SS_WSB_WDDF1EF07.54 3.2.1.9.19SS_WSB_RDDF1EF08.54 3.2.1.9.20SS_WSB_WDDF1EF08.55 3.2.1.9.21SS_WSB_RDF01EF05.55 3.2.1.9.22SS_WSB_WDF01EF05 .55 3.2.1.9.23SS_WSB_RDF01EF06.56 3.2.1.9.24S

25、S_WSB_WDF01EF06 .56 3.2.1.9.25SS_WSB_RDF01EF07.57 3.2.1.9.26SS_WSB_WDF01EF07 .57 3.2.1.9.27SS_WSB_RDF01EF08.57 3.2.1.9.28SS_WSB_WDF01EF08 .58 3.2.1.9.29SS_WSB_RDF02EF05.58 3.2.1.9.30SS_WSB_WDF02EF05 .59 3.2.1.9.31SS_WSB_RDF02EF06.59 3.2.1.9.32SS_WSB_WDF02EF06 .59 3.2.1.9.33SS_WSB_RDF02EF07.60 3.2.1.

26、9.34SS_WB_WDF02EF07.60 3.2.1.9.35SS_WSB_RDF02EF08.60 3.2.1.9.36SS_WSB_WDF02EF08 .61 3.2.1.9.37SS_WSB_SM3Digest.61 3.2.1.9.38SS_WSB_SM2SignHash.61 3.2.1.9.39SS_WSB_RDF03EF05.62 3.2.1.9.40SS_WSB_WDF03EF05 .62 3.2.1.9.41SS_WSB_EDF03EF05.62 3.2.1.9.42SS_WSB_RDF03EF06.63 3.2.1.9.43SS_WSB_WDF03EF06 .63 3.

27、2.1.9.44SS_WSB_EDF03EF06.63 3.2.1.9.45SS_DC_RSign_DF03EE00.63 3.2.1.9.46SS_DC_RDF03EE00 .64 3.2.1.9.47SS_DC_WDF03EE00 .64 3.2.1.9.48SS_DC_RSign_DF03ED00.65 3.2.1.9.49SS_DC_RDF03ED00.65 用户手册 第 7 页 共 77 页 3.2.1.9.50SS_DC_WDF03ED00.65 3.2.1.9.51SS_WSB_RDF03EE00 .66 3.2.1.9.52SS_WSB_WDF03EE00.66 3.2.1.9

28、.53SS_WSB_RDF03ED00.66 3.2.1.9.54SS_WSB_WDF03ED00.67 3.2.1.10指纹采集比对.67 3.2.1.10.1SS_ZW_Init.67 3.2.1.10.2SS_ZW_Close .68 3.2.1.10.3SS_ZW_GetErrorInfo.68 3.2.1.10.4SS_ZW_GetFPBmpData.68 3.2.1.10.5SS_ZW_GetCharFromSensor .68 3.2.1.10.6SS_ZW_Match2Char .68 3.2.1.10.7SS_ZW_GetCharFromBMP.68 3.2.1.10.8SS

29、_ZW_MatchCharFromSensor.68 3.2.1.10.9MPS_*.69 4附录附录.70 4.1门诊、住院记录 TAG 定义.70 用户手册 第 8 页 共 77 页 1 终端简介终端简介 SS728M05 是一款支持身份证、社保卡、居民健康卡、磁条卡等多种卡类型的多合一的读写终端，支持 USB 通讯，采用模块化设计，适用于医院等发卡行业。 1.1 主要功能 名 称性 能 说 明 非接触式卡支持符合 IS014443-4 协议的 TYPEA 智能卡和 TYPEB 智能卡； 二次开发提供进行业务系统的二次开发。 软件开发包含有 DEMO 程序，开发说明书，开发库。 PSAM

30、卡接口同时可附加 3 个符合 GSM 11.11 的 Sim 的卡尺寸 SAM 卡座。 操作系统 支持 Windows Xp/7/8/8.1；Windwos Server 2003/2008 等操作系统。 与 PC 通讯类型USB 通讯。 1.2 主要技术指标 参 数指 标 射频谐振频率13.56MHz 土 25Hz SAM 卡通讯速率9600/38400 工作电流 400mA 外形尺寸 18511558（长宽高）单位：mm 工作温度 050 工作湿度 93，20% 电磁兼容性符合 GB 9254-2008 中相应级别 B 级规定的要求。 用户手册 第 9 页 共 77 页 2 接口库概述接口

31、库概述 2.1 适用范围 本设备驱动接口函数库适用于山东神思 SS728M05 多合一读卡终端。 本设备驱动接口函数库适用于 Windows 操作系统。 2.2 说明 本手册规定了 SS728M05 多合一读卡终端的设备驱动接口函数库； 设备驱动接口函数库负责设备驱动与通讯，向读卡终端发送命令，接收来自读卡终端的应答。对命令进 行处理后通过函数的返回值和参数返回处理结果。 设备驱动接口支持 USB 通讯模式。 用户手册 第 10 页 共 77 页 3 接口函数接口函数 3.1 函数返回值 对于没有特殊说明的设备驱动接口函数，当返回值等于 0 时，表示成功；小于 0 时表示操作失败。 3.1.1

32、 通用返回值 表格 1 定义了高级应用编程接口函数的通用返回值。 错误代码说明 0命令成功 -1卡片类型不对 -2无卡 -3多卡片冲突 -4卡片无应答 -5接口设备故障 -6不支持该命令 -7命令长度错误 -8命令参数错误 -9信息校验和出错 -11SAM 卡没有插入 用户手册 第 11 页 共 77 页 3.1.2 居民健康卡（兼容山东保健证）错误代码 表格 2 定义了居民健康卡（兼容山东保健证）错误代码 错误代码说明 -63sm2 获取哈希数据失败 -64sm3 获取哈希数据失败 -65计算过程密钥错误 -66SAM 卡选择文件错误 -67SAM 卡校验 PIN 失败 -68SAM 卡没有

33、插入 -201没有寻卡医联卡 -202没有连接设备 -203内部认证失败 -204选择文件失败或外部认证失败 -205读文件失败(没有文件或记录) -206写文件失败 -207读照片解码失败 -208照片解码失败 -209写照片时，解码失败 -210擦除记录失败 -211读卡器通讯出错 -9991卡版本判断失败 -2630 x外部认证失败，外部认证次数还剩 x 次 -26983此应用已锁定 -30001读卡器连接故障 -30002读卡器通信故障 -30003参数错 -30004非法密钥 -30005调用 DLL 失败 -30006照片解码失败 -30007照片文件创建 -30099命令执行失败

34、 用户手册 第 12 页 共 77 页 3.2 基本接口函数 3.2.1 SS728M05_SDK（SS728M05 基本操作接口） 3.2.1.1基本函数 ICC 开头的接口为根据卫生部要求提供。 3.2.1.1.1 ICC_Reader_Open 函数：int ICC_Reader_Open(void) 功能：该函数通知终端操作系统打开与接口设备所对应的终端设备端口，以便两者建立通信的逻辑关系。 参数说明：无 返回值：如果函数执行成功，则返回值为不小于 0 的设备句柄；否则，表示函数执行失败，返回错误代 码。 3.2.1.1.2 ICC_Reader_Close 函数：int ICC_Re

35、ader_Close(int ReaderHandle) 功能：该函数通知操作系统关闭所指定的设备。 参数说明： (1) ReaderHandle：接口设备句柄。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.3 ICC_Reader_Reset 函数：int ICC_Reader_Reset(int ReaderHandle, int ICC_Slot_No,unsigned char * Response,int *RespLen) 功能：该函数要求接口设备等待一个非接触卡进场或者 SAM 卡、接触式 IC 卡插入并对其进行复位。 参数说

36、明： (1) ReaderHandle：接口设备句柄。 (2) ICC_Slot_No：卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值范围为 1F，ESAM：0 x10； 0 x00非接触卡 0 x01SAM1 0 x02SAM2 0 x03SAM3 0 x04接触 IC 卡 0 x10ESAM 0 x30SLE4442 卡 用户手册 第 13 页 共 77 页 0 x31SLE4428 卡 (3) Response：指向存放响应数据的存储区的指针。存储区中返回卡片的复位应答字节和存储区中的字节 数；如果对卡片复位不成功，则存储区不返回任何数据。 (4) RespLe

37、n：返回值长度。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.4 ICC_Reader_PowerOff 函数：int ICC_Reader_PowerOff (int ReaderHandle, int ICC_Slot_No,) 功能：该函数要求接口设备撤消与 ICC 之间的电气连接。 参数说明： (1) ReaderHandle：接口设备句柄。 (2) ICC_Slot_No：卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值范围为 1F，ESAM：0 x10。 返回值：如果该函数成功执行，则返回值为 0；否则，

38、表示函数执行失败，返回错误代码。 3.2.1.1.5 ICC_Reader_Application 函数：int ICC_Reader_Application( int ReaderHandle, int ICC_Slot_No, int Length_of_Command_APDU, char * Command_APDU, char * Response_APDU, int *RespLen) 功能：该函数用于将符合 GB/T16649.3 中所规定的基本和特殊功能的行业间交换用命令发送给指定的卡 槽上的卡，并获取对应的响应。 参数说明： (1) ReaderHandle：接口设备句柄。

39、(2) ICC_Slot_No：卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值范围为 13，ESAM：0 x10； 0 x00非接触卡 0 x01SAM1 0 x02SAM2 0 x03SAM3 0 x04接触 IC 卡 0 x10ESAM 0 x20密码键盘 0 x30SLE4442 卡 0 x31SLE4428 卡 (3) Length_of_Command_APDU：其值为 Command_APDU 所指向缓冲区中的字节数。 (4) Command_APDU：指向存放命令的缓冲区的指针。 (5) Response：指向存放响应数据的存储区的指针。 (6) Res

40、pLen 返回值长度。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.6 ICC_Reader_GetLastError 函数：int ICC_Reader_GetLastError(void) 功能：查询终端最近一次的错误信息。 参数说明：无 用户手册 第 14 页 共 77 页 返回值：返回 0 表示终端没有出错信息；否侧，返回值小于 0 为错误代码。 3.2.1.1.7 ICC_Reader_Version 函数： int ICC_Reader_Version (char* info) 功能： 该函数取得当前终端的厂家信息。 参数说明：

41、 (1) info：指向存放厂家信息的存储区的指针。具体含义参见如下表格： 表格 3 厂家信息的存储格式 第 116 字符第 1730 字符第 3132 字符 厂家名称（不足补空格） 设备型号或系列号（不足补空格） 固件版本号 返回值： 如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.8 SS_Reader_Reset 函数： int SS_Reader_Reset(int ReaderHandle,unsigned char* ICC_Slot_No,unsigned char * Response,int *RespLen) 功能： 该函数要求接口

42、设备等待一个非接触卡进场或者 SAM 卡、接触式 IC 卡插入并对其进行复位。 参数说明： (1) ReaderHandle：接口设备句柄。 (2) ICC_Slot_No：ICC_Slot_No0:卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值范围为 13，ESAM：0 x10； 0 x00非接触卡 0 x01SAM1 0 x02SAM2 0 x03SAM3 0 x04接触 IC 卡 0 x10ESAM 0 x20密码键盘 0 x30SLE4442 卡 0 x31SLE4428 卡 ICC_Slot_No1: 接触卡 SLOT_MASK说明 0 x00BRT=960

43、0 0 x01BRT=38400 非接卡 SLOT_MASK = 0 x11,操作 ISO14443_4 TypeA 卡 SLOT_MASK = 0 x12,操作 ISO14443_4 TypeB 卡 SLOT_MASK = 0 x13,操作第二代居民身份证 SLOT_MASK = 0 x14,操作同方 1064 卡 SLOT_MASK = 0 x15,操作 Mifare 卡 (3) Response：指向存放响应数据的存储区的指针。存储区中返回卡片的复位应答字节和存储区中的字节 用户手册 第 15 页 共 77 页 数；如果对卡片复位不成功，则存储区不返回任何数据。 (4) RespLen：

44、返回值长度。 返回值： 如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.9 SS_Reader_Reset_bBeep 函数： int SS_Reader_Reset_bBeep(int ReaderHandle,unsigned char* ICC_Slot_No,unsigned char * Response,int *RespLen ,bool bBeep) 功能： 该函数要求接口设备等待一个非接触卡进场或者 SAM 卡、接触式 IC 卡插入并对其进行复位。 参数说明： (1) ReaderHandle：接口设备句柄； (2) ICC_Slot

45、_No：ICC_Slot_No0:卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值范围为 13，ESAM：0 x10； 0 x00非接触卡 0 x01SAM1 0 x02SAM2 0 x03SAM3 0 x04接触 IC 卡 0 x10ESAM 0 x20密码键盘 0 x30SLE4442 卡 0 x31SLE4428 卡 ICC_Slot_No1: 接触卡 SLOT_MASK说明 0 x00BRT=9600 0 x01BRT=38400 非接卡 SLOT_MASK = 0 x11,操作 ISO14443_4 TypeA 卡 SLOT_MASK = 0 x12,操作 I

46、SO14443_4 TypeB 卡 SLOT_MASK = 0 x13,操作第二代居民身份证 SLOT_MASK = 0 x14,操作同方 1064 卡 SLOT_MASK = 0 x15,操作 Mifare 卡 (3) Response：指向存放响应数据的存储区的指针。存储区中返回卡片的复位应答字节和存储区中的字节 数；如果对卡片复位不成功，则存储区不返回任何数据。 (4) RespLen 返回值长度。 (5) bBeep：如果出现异常是否蜂鸣，true 为蜂鸣，false 不蜂鸣。 返回值： 如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.10SS

47、_Reader_PowerOff 函数：int SS_Reader_PowerOff (int ReaderHandle, unsigned char ICC_Slot_No) 功能：该函数要求接口设备撤消与卡片之间的电气连接。 参数说明： (1) ReaderHandle：接口设备句柄； 用户手册 第 16 页 共 77 页 (2) ICC_Slot_No：卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值范围为 1F，ESAM：0 x10； (3) 返回值： 如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.11SS_Reade

48、r_Application 函数：int SS_Reader_Application( int ReaderHandle, unsigned char* ICC_Slot_No,int Length_of_Command_APDU,char * Command_APDU,char * Response_APDU,int *RespLen) 功能：该函数用于将命令发送给指定的卡槽上的卡，并获取对应的响应。 参数说明： (1) ReaderHandle：接口设备句柄。 (2) ICC_Slot_No：ICC_Slot_No0:卡槽号，非接触卡槽:0 x00，SAM1:0 x0n, 其中“n”的取值

49、范围为 13，ESAM：0 x10； 0 x00非接触卡 0 x01SAM1 0 x02SAM2 0 x03SAM3 0 x04接触 IC 卡 0 x10ESAM 0 x20密码键盘 0 x30SLE4442 卡 0 x31SLE4428 卡 ICC_Slot_No1: 接触卡 SLOT_MASK说明 0 x00BRT=9600 0 x01BRT=38400 非接卡 SLOT_MASK = 0 x11,操作 ISO14443_4 TypeA 卡 SLOT_MASK = 0 x12,操作 ISO14443_4 TypeB 卡 SLOT_MASK = 0 x13,操作第二代居民身份证 SLOT_M

50、ASK = 0 x14,操作同方 1064 卡 SLOT_MASK = 0 x15,操作 Mifare 卡 (3) Length_of_Command_APDU：其值为 Command_APDU 所指向缓冲区中的字节数。 (4) Command_APDU：指向存放命令的缓冲区的指针。 (5) Response：指向存放响应数据的存储区的指针。 (6) RespLen 返回值长度。 返回值： 如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.12SS_Reader_GetLastError 函数：int SS_Reader_GetLastError(voi

51、d) 功能：获取最后一次命令执行的错误码。 参数说明：无 返回值：返回 0 表示终端没有出错信息；否侧，返回值小于 0 为错误代码。 用户手册 第 17 页 共 77 页 3.2.1.1.13SS_Reader_Version 函数：int SS_Reader_Version(char* devver) 功能：获取设备信息（厂商(16 字节)+设备名称(14 字节)+版本(2 字节)） 。 参数说明： (1) devver：获取设备版本信息（厂商+设备名称+版本） 。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.14SS_Reader_Ge

52、tVersionID 函数：int SS_Reader_GetVersionID(int index,char* VersionID) 功能：获取终端信息。 参数说明： (1) index：信息编号 1：硬件版本号（硬件版本号（设备名称(8 字节)+版号(4 字节)+固件版本(4 字节)+射 频库版本(4 字节)+接触卡库版本(4 字节)） ） ；2：产品序列号（生产单位字母缩写（2 位）+产品型号代码 （4 位）+生产日期（年月日，8 位）+顺序号（4 位） ） 。 (2) VersionID：获取的信息数据。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。

53、 3.2.1.1.15SS_Reader_GetUserInfo 函数：int SS_Reader_GetUserInfo(int index,char* UserInfo); 功能：获取用户信息。 参数说明： (1) index：信息编号 1：客户编码；2：终端编码。 (2) UserInfo：获取的信息数据，最长 40 字节。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.16SS_Reader_UpdateUserInfo 函数：int SS_Reader_UpdateUserInfo(int index,char* UserInfo)

54、; 功能：获取用户信息。 参数说明： (1) index：信息编号 1：客户编码；2：终端编码。 (2) UserInfo：设置的信息数据，最长 40 字节。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.17SS_Reader_AutoRecognition 函数：int SS_Reader_AutoRecognition () 功能：自动寻卡，返回当前卡类型。 参数说明：无 返回值：成功返回 1-6（1：居民健康卡；2：保健证（COS1） ；3：保健证（COS2） ；4：居民身份证； 用户手册 第 18 页 共 77 页 5：标准社保卡（

55、CPU 卡） ；6：SLE4428 卡；0 xAA：未知的非接触卡；0 xBB：未知的接触卡） 。 3.2.1.1.18SS_Reader_AutoFindCard 函数：long SS_Reader_AutoFindCard (long ReaderHandle) 功能：自动判断当前卡类型并寻卡上电。 参数说明： (1) ReaderHandle：设备句柄。 返回值：如果函数执行成功，则返回大于 0 的卡类型代码（1：标准社保卡；2：济南社保卡；3：山东省 保健证） ；否则，表示函数执行失败，返回错误代码。 注：建议使用流程：ss_reader_open（打开设备）SS_Reader_Aut

56、oFindCard (自动寻卡上电)相应卡片操 作ss_reader_close(关闭设备)。 3.2.1.1.19ss_dev_beep 函数：long ss_dev_beep(long icdev,unsigned short _Amount,unsigned short _Msec) 功能：控制蜂鸣器，控制读卡终端的蜂鸣器鸣响。 参数说明： (1) icdev：设备句柄。 (2) _Amount：鸣响次数。 (3) _Msec：鸣响时间，以 100 毫秒为单位。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.1.20ss_dev_led 函

57、数：long ss_dev_led(long icdev,BYTE _LedClr,BYTE _LedCtrl,unsigned short _Amount,unsigned short _Msec) 功能：控制指示灯。 参数说明： (1) icdev：设备句柄。 (2) _LedClr,：0 表示故障灯，1 表示工作灯。 (3) _LedCtrl：1 表示长亮，2 表示长灭，3 表示闪烁。接口库暂不支持设置故障灯常亮操作，防止与设备 故障时点亮故障灯操作冲突。 (4) _Amount：闪烁次数。 (5) _Msec：闪烁时间间隔，100 毫秒为单位。 返回值：如果函数执行成功，则返回值为 0

58、；否则，表示函数执行失败，返回错误代码。 3.2.1.2居民二代身份证函数 推荐读卡流程：打开设备卡片复位读卡获得数据关闭设备 用户手册 第 19 页 共 77 页 3.2.1.2.1 ss_id_ResetID2Card 函数：long ss_id_ResetID2Card(long icdev) 功能：复位 参数说明： (1) icdev：设备句柄。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.2.2 ss_id_read_card 函数：long ss_id_read_card(long icdev ,int Flag=0) 功能：用于读

59、取身份证卡信息，调用成功后，读出的身份证信息将保存在库内部存储中，可以使用以 ss_id_query_开头的函数去读取这些内部存储中的信息。 参数说明： (1) icdev：设备句柄。 (2) Flag：如果是 0，读取基本信息数据，如果是其他值则读取基本信息加指纹信息数据。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.2.3 ss_id_query_name 函数：long ss_id_query_name(long icdev,char* _Name) 功能：从库内部存储中取身份证卡的姓名信息。 参数说明： (1) icdev：设备句柄。

60、(2) _Name：姓名，不超过 15 个汉字，以0结束。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.2.4 ss_id_query_sex 函数：long ss_id_query_sex(long icdev,char* _Sex) 功能：从库内部存储中取身份证卡的性别编码信息。 参数说明： (1) icdev：设备句柄。 (2) _Sex：国家标准的性别编码，1 个数字字符，以0结束。 返回值：如果函数执行成功，则返回值为 0；否则，表示函数执行失败，返回错误代码。 3.2.1.2.5 ss_id_query_sexL 函数：long s