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

1、神思SS728M05终端API接口函数库用户手册V16概要 文档编号归档编号发布状态文档版本SS728M05设备驱动接口函数库用 户 手 册V1.6拟 制： 陈龙 日期：2014-12-26审 核： 日期： 标准化： 日期：批 准： 日期：山 东 神 思 电 子目 录SS728M05设备驱动接口函数库 1用 户 手 册 1V1.6 1目 录 21 终端简介 81.1 主要功能 81.2 主要技术指标 82 接口库概述 92.1 适用范围 92.2 说明 93 接口函数 103.1 函数返回值 103.1.1 通用返回值 103.1.2 居民健康卡（兼容山东保健证）错误代码 113.2 基本接口

2、函数 123.2.1 SS728M05_SDK（SS728M05基本操作接口） 123.2.1.1 基本函数 123.2.1.1.1 ICC_Reader_Open 123.2.1.1.2 ICC_Reader_Close 123.2.1.1.3 ICC_Reader_Reset 123.2.1.1.4 ICC_Reader_PowerOff 133.2.1.1.5 ICC_Reader_Application 133.2.1.1.6 ICC_Reader_GetLastError 133.2.1.1.7 ICC_Reader_Version 143.2.1.1.8 SS_Reader_Res

3、et 143.2.1.1.9 SS_Reader_Reset_bBeep 153.2.1.1.10 SS_Reader_PowerOff 153.2.1.1.11 SS_Reader_Application 163.2.1.1.12 SS_Reader_GetLastError 163.2.1.1.13 SS_Reader_Version 163.2.1.1.14 SS_Reader_GetVersionID 173.2.1.1.15 SS_Reader_GetUserInfo 173.2.1.1.16 SS_Reader_UpdateUserInfo 173.2.1.1.17 SS_Read

4、er_AutoRecognition 173.2.1.1.18 SS_Reader_AutoFindCard 183.2.1.1.19 ss_dev_beep 183.2.1.1.20 ss_dev_led 183.2.1.2 居民二代身份证函数 183.2.1.2.1 ss_id_ResetID2Card 183.2.1.2.2 ss_id_read_card 193.2.1.2.3 ss_id_query_name 193.2.1.2.4 ss_id_query_sex 193.2.1.2.5 ss_id_query_sexL 193.2.1.2.6 ss_id_query_folk 19

5、3.2.1.2.7 ss_id_query_folkL 203.2.1.2.8 ss_id_query_birth 203.2.1.2.9 ss_id_query_address 203.2.1.2.10 ss_id_query_number 203.2.1.2.11 ss_id_query_organ 213.2.1.2.12 ss_id_query_termbegin 213.2.1.2.13 ss_id_query_termend 213.2.1.2.14 ss_id_query_photo_data 213.2.1.2.15 ss_id_query_photo_file 213.2.1

6、.2.16 ss_id_query_newaddress 223.2.1.2.17 ss_id_query_IDBaseInfo_text 223.2.1.2.18 ss_id_GetSAMno 223.2.1.2.19 ss_id_GetSAMStatus 233.2.1.2.20 ss_id_GetFPMsg 233.2.1.3 M1卡操作函数 233.2.1.3.1 ss_CardMifare_Reset 233.2.1.3.2 ss_CardMifare_Authentication 233.2.1.3.3 ss_CardMifare_ReadBlock 243.2.1.3.4 ss_

7、CardMifare_WriteBlock 243.2.1.3.5 ss_CardMifare_Increment 243.2.1.3.6 ss_CardMifare_Decrement 243.2.1.3.7 ss_CardMifare_Copy 243.2.1.3.8 ss_CardMifare_GetUID 253.2.1.4 标准社保卡操作作函数 253.2.1.4.1 ss_rf_sb_FindCard 253.2.1.4.2 ss_rf_sb_ReadCardIssuers 253.2.1.4.3 ss_rf_sb_ReadCardholder 263.2.1.4.4 ss_rf_

8、sb_ReadFingerprint 263.2.1.5 济南社保卡操作函数 263.2.1.5.1 ss_jn_sb_FindCard 263.2.1.5.2 ss_jn_sb_QuerryCardNumber 263.2.1.6 4428卡操作函数 273.2.1.6.1 ss_sle_reset_card 273.2.1.6.2 ss_sle4428_read_card 273.2.1.7 磁条卡操作作函数 273.2.1.7.1 SS_CT_ReadInfo 273.2.1.7.2 SS_CT_ReadInfo_ 283.2.1.8 居民健康卡基本函数(兼容山东保健证) 283.2.1

9、.8.1 ss_reader_open 283.2.1.8.2 ss_reader_close 293.2.1.8.3 ss_rf_yl_cpu_find_card 293.2.1.8.4 ss_lib_version 293.2.1.8.5 ss_rf_yl_cpu_find_cardB 293.2.1.8.6 ss_rf_cpu_yl_read_cardInfo 293.2.1.8.7 ss_rf_cpu_yl_write_cardInfo 293.2.1.8.8 ss_rf_yl_cpu_read_issuingOrg 303.2.1.8.9 ss_rf_yl_cpu_write_iss

10、uingOrg 303.2.1.8.10 ss_rf_yl_cpu_read_demographicInfo1 303.2.1.8.11 ss_rf_yl_cpu_write_demographicInfo1 303.2.1.8.12 ss_rf_yl_cpu_read_hospital 313.2.1.8.13 ss_rf_yl_cpu_write_hospital 313.2.1.8.14 ss_rf_cpu_yl_read_photo 313.2.1.8.15 ss_rf_cpu_yl_write_photo 313.2.1.8.16 ss_rf_yl_cpu_read_address

11、323.2.1.8.17 ss_rf_yl_cpu_write_address 323.2.1.8.18 ss_rf_yl_cpu_read_linkman 323.2.1.8.19 ss_rf_yl_cpu_write_linkman 323.2.1.8.20 ss_rf_yl_cpu_read_demographicInfo2 333.2.1.8.21 ss_rf_yl_cpu_write_demographicInfo2 333.2.1.8.22 ss_rf_yl_cpu_read_idcardInfo 333.2.1.8.23 ss_rf_yl_cpu_write_idcardInfo

12、 333.2.1.8.24 ss_rf_yl_cpu_read_illNum 343.2.1.8.25 ss_rf_yl_cpu_write_illNum 343.2.1.8.26 ss_rf_yl_cpu_read_BiometricIdentifier 343.2.1.8.27 ss_rf_yl_cpu_write_BiometricIdentifier 343.2.1.8.28 ss_rf_yl_cpu_read_SpecialIdentifier 353.2.1.8.29 ss_rf_yl_cpu_write_SpecialIdentifier 353.2.1.8.30 ss_rf_y

13、l_cpu_read_AllergicReaction 353.2.1.8.31 ss_rf_yl_cpu_write_AllergicReaction 353.2.1.8.32 ss_rf_yl_cpu_read_Immunization 363.2.1.8.33 ss_rf_yl_cpu_write_Immunization 363.2.1.8.34 ss_rf_yl_cpu_read_HospitalEffectiveSign 363.2.1.8.35 ss_rf_yl_cpu_write_HospitalEffectiveSign 363.2.1.8.36 ss_rf_yl_cpu_R

14、ewriteRecord_HospitalEffectiveSign 373.2.1.8.37 ss_rf_yl_cpu_EraseRecord_HospitalEffectiveSign 373.2.1.8.38 ss_rf_yl_cpu_read_OutpatientServiceEffectiveSign 373.2.1.8.39 ss_rf_yl_cpu_write_OutpatientServiceEffectiveSign 373.2.1.8.40 ss_rf_yl_cpu_RewriteRecord_OutpatientServiceEffectiveSign 383.2.1.8

15、.41 ss_rf_yl_cpu_EraseRecord_OutpatientServiceEffectiveSign 383.2.1.8.42 ss_rf_cpu_yl_read_HospitalInformation1 383.2.1.8.43 ss_rf_cpu_yl_write_HospitalInformation1 383.2.1.8.44 ss_rf_cpu_yl_read_HospitalInformation2 393.2.1.8.45 ss_rf_cpu_yl_write_HospitalInformation2 393.2.1.8.46 ss_rf_cpu_yl_read

16、_OutpatientServiceInformation1 393.2.1.8.47 ss_rf_cpu_yl_write_OutpatientServiceInformation1 393.2.1.8.48 ss_rf_cpu_yl_read_OutpatientServiceInformation2 403.2.1.8.49 ss_rf_cpu_yl_write_OutpatientServiceInformation2 403.2.1.8.50 ss_rf_cpu_yl_read_FingerprintFile 403.2.1.8.51 ss_rf_cpu_yl_write_Finge

17、rprintFile 413.2.1.8.52 ss_rf_cpu_yl_GetCardUid 413.2.1.8.53 ss_rf_cpu_yl_read_HospitalInformation3 413.2.1.8.54 ss_rf_cpu_yl_write_HospitalInformation3 413.2.1.8.55 ss_rf_cpu_yl_read_OutpatientServiceInformation3 423.2.1.8.56 ss_rf_cpu_yl_write_OutpatientServiceInformation3 423.2.1.8.57 ss_rf_cpu_y

18、l_read_OutpatientServiceInformation4 423.2.1.8.58 ss_rf_cpu_yl_write_OutpatientServiceInformation4 423.2.1.8.59 ss_rf_cpu_yl_read_OutpatientExpenses 433.2.1.8.60 ss_rf_cpu_yl_write_OutpatientExpenses 433.2.1.8.61 ss_rf_cpu_yl_AppcationLock_ddf1 433.2.1.8.62 ss_rf_cpu_yl_AppcationUnLock_ddf1 433.2.1.

19、8.63 ss_rf_cpu_yl_AppcationLock_df01 443.2.1.8.64 ss_rf_cpu_yl_AppcationUnLock_df01 443.2.1.8.65 ss_rf_cpu_yl_AppcationLock_df02 443.2.1.8.66 ss_rf_cpu_yl_AppcationUnLock_df02 443.2.1.8.67 ss_rf_cpu_yl_AppcationLock_df03 443.2.1.8.68 ss_rf_cpu_yl_AppcationUnLock_df03 453.2.1.8.69 ss_rf_cpu_yl_CardLo

20、ck 453.2.1.8.70 ss_rf_cpu_yl_read_PayInfoFile 453.2.1.8.71 ss_rf_cpu_yl_write_PayInfoFile 453.2.1.8.72 ss_rf_VerifyPINSAM1 453.2.1.8.73 ss_rf_ResetSAM1AndVerifyPIN 463.2.1.8.74 ss_rf_cpu_yl_read_Binaryphoto 463.2.1.8.75 ss_rf_cpu_yl_write_Binaryphoto 463.2.1.8.76 ss_rf_cup_yl_GetCardVersion 463.2.1.

21、8.77 ss_rf_SAM_Reset 463.2.1.8.78 ss_rf_SAM_VerifyPIN 473.2.1.8.79 ss_rf_SAM_ChangePIN 473.2.1.8.80 ss_rf_SAM_Public 473.2.1.8.81 ss_rf_SAM_Terminal 473.2.1.8.82 ss_rf_SAM_PublicApp 483.2.1.8.83 ss_rf_SAM_OrgCertificate 483.2.1.8.84 ss_rf_SAM_Certificate 483.2.1.8.85 ss_rf_SAM_SM3Digest 483.2.1.8.86

22、 ss_rf_SAM_SM2SignHash 493.2.1.9 居民健康卡高级函数 493.2.1.9.1 SS_WSB_OpenDevice 493.2.1.9.2 SS_WSB_CloseDevice 493.2.1.9.3 SS_WSB_PowerOn 503.2.1.9.4 SS_DC_ PowerOff 503.2.1.9.5 SS_DC_SetSpacer 503.2.1.9.6 SS_WSB_SendAPDU 503.2.1.9.7 SS_DC_Get_Version 513.2.1.9.8 SS_WSB_VerifyPIN 513.2.1.9.9 SS_DC_ChangePI

23、N 513.2.1.9.10 SS_DC_RSAMPublic 523.2.1.9.11 SS_DC_RSAMTerminal 523.2.1.9.12 SS_DC_RSAMPublicApp 523.2.1.9.13 SS_DC_RSAMOrgCertificate 523.2.1.9.14 SS_DC_RSAMCertificate 533.2.1.9.15 SS_WSB_RDDF1EF05 533.2.1.9.16 SS_WSB_RDDF1EF06 533.2.1.9.17 SS_WSB_RDDF1EF07 543.2.1.9.18 SS_WSB_WDDF1EF07 543.2.1.9.

24、19 SS_WSB_RDDF1EF08 543.2.1.9.20 SS_WSB_WDDF1EF08 553.2.1.9.21 SS_WSB_RDF01EF05 553.2.1.9.22 SS_WSB_WDF01EF05 553.2.1.9.23 SS_WSB_RDF01EF06 563.2.1.9.24 SS_WSB_WDF01EF06 563.2.1.9.25 SS_WSB_RDF01EF07 573.2.1.9.26 SS_WSB_WDF01EF07 573.2.1.9.27 SS_WSB_RDF01EF08 573.2.1.9.28 SS_WSB_WDF01EF08 583.2.1.9.

25、29 SS_WSB_RDF02EF05 583.2.1.9.30 SS_WSB_WDF02EF05 593.2.1.9.31 SS_WSB_RDF02EF06 593.2.1.9.32 SS_WSB_WDF02EF06 593.2.1.9.33 SS_WSB_RDF02EF07 603.2.1.9.34 SS_WB_WDF02EF07 603.2.1.9.35 SS_WSB_RDF02EF08 603.2.1.9.36 SS_WSB_WDF02EF08 613.2.1.9.37 SS_WSB_SM3Digest 613.2.1.9.38 SS_WSB_SM2SignHash 613.2.1.9

26、.39 SS_WSB_RDF03EF05 623.2.1.9.40 SS_WSB_WDF03EF05 623.2.1.9.41 SS_WSB_EDF03EF05 623.2.1.9.42 SS_WSB_RDF03EF06 633.2.1.9.43 SS_WSB_WDF03EF06 633.2.1.9.44 SS_WSB_EDF03EF06 633.2.1.9.45 SS_DC_RSign_DF03EE00 633.2.1.9.46 SS_DC_RDF03EE00 643.2.1.9.47 SS_DC_WDF03EE00 643.2.1.9.48 SS_DC_RSign_DF03ED00 653

27、.2.1.9.49 SS_DC_RDF03ED00 653.2.1.9.50 SS_DC_WDF03ED00 653.2.1.9.51 SS_WSB_RDF03EE00 663.2.1.9.52 SS_WSB_WDF03EE00 663.2.1.9.53 SS_WSB_RDF03ED00 663.2.1.9.54 SS_WSB_WDF03ED00 673.2.1.10 指纹采集比对 673.2.1.10.1 SS_ZW_Init 673.2.1.10.2 SS_ZW_Close 683.2.1.10.3 SS_ZW_GetErrorInfo 683.2.1.10.4 SS_ZW_GetFPBm

28、pData 683.2.1.10.5 SS_ZW_GetCharFromSensor 683.2.1.10.6 SS_ZW_Match2Char 683.2.1.10.7 SS_ZW_GetCharFromBMP 683.2.1.10.8 SS_ZW_MatchCharFromSensor 683.2.1.10.9 MPS_* 694 附录 704.1 门诊、住院记录 Tag 定义 701 终端简介SS728M05是一款支持身份证、社保卡、居民健康卡、磁条卡等多种卡类型的多合一的读写终端，支持USB通讯，采用模块化设计，适用于医院等发卡行业。1.1 主要功能名 称性 能 说 明非接触式卡支持符

29、合IS014443-4协议的TYPEA智能卡和TYPEB智能卡；二次开发提供进行业务系统的二次开发。软件开发包含有DEMO程序，开发说明书，开发库。PSAM卡接口同时可附加3个符合GSM 11.11的Sim的卡尺寸SAM卡座。操作系统支持Windows Xp/7/8/8.1；Windwos Server 2003/2008等操作系统。与PC通讯类型USB通讯。1.2 主要技术指标参 数指 标射频谐振频率13.56MHz土25HzSAM卡通讯速率9600/38400工作电流400mA外形尺寸18511558（长宽高）单位：mm工作温度050工作湿度93，20%电磁兼容性符合GB 9254-200

30、8中相应级别B级规定的要求。2 接口库概述2.1 适用范围本设备驱动接口函数库适用于山东神思SS728M05多合一读卡终端。本设备驱动接口函数库适用于Windows操作系统。2.2 说明本手册规定了SS728M05多合一读卡终端的设备驱动接口函数库；设备驱动接口函数库负责设备驱动与通讯，向读卡终端发送命令，接收来自读卡终端的应答。对命令进行处理后通过函数的返回值和参数返回处理结果。设备驱动接口支持USB通讯模式。3 接口函数3.1 函数返回值对于没有特殊说明的设备驱动接口函数，当返回值等于0时，表示成功；小于0时表示操作失败。3.1.1 通用返回值表格1定义了高级应用编程接口函数的通用返回值。错误代码说明0命令成功-1卡片类型不对 -2无卡 -3多卡片冲突-4卡片无应答-5接口设备故障-6不支持该命令-7命令长度错误-8命令参数错误 -9信息校验和出错-11SAM卡没有插入3.1.2 居民健康卡（兼容山东保健证）错误代码表格2定义了居民健康卡（兼容山东保健证）错误代码错误代码说明-63sm2获取哈希数据失败-64sm3获取哈希数据失败-65计算过程密钥错误-66SAM卡选择文件错误-67SAM卡校验PIN失败-68SAM卡没有插入-201没有寻卡医联卡-202没有连接设备-203内部认证失败-204选择文