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

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

《神思SS728M05终端API接口函数库用户手册V16概要.docx》由会员分享，可在线阅读，更多相关《神思SS728M05终端API接口函数库用户手册V16概要.docx（118页珍藏版）》请在冰豆网上搜索。

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

文档编号

归档编号

发布状态

文档版本

SS728M05设备驱动接口函数库

用户手册

V1.6

拟制：

陈龙日期：

2014-12-26

审核：

日期：

标准化：

日期：

批准：

日期：

山东神思电子

目录

SS728M05设备驱动接口函数库1

用户手册1

V1.61

目录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.1.2居民健康卡（兼容山东保健证）错误代码11

3.2基本接口函数12

3.2.1SS728M05_SDK（SS728M05基本操作接口）12

3.2.1.1基本函数12

3.2.1.1.1ICC_Reader_Open12

3.2.1.1.2ICC_Reader_Close12

3.2.1.1.3ICC_Reader_Reset12

3.2.1.1.4ICC_Reader_PowerOff13

3.2.1.1.5ICC_Reader_Application13

3.2.1.1.6ICC_Reader_GetLastError13

3.2.1.1.7ICC_Reader_Version14

3.2.1.1.8SS_Reader_Reset14

3.2.1.1.9SS_Reader_Reset_bBeep15

3.2.1.1.10SS_Reader_PowerOff15

3.2.1.1.11SS_Reader_Application16

3.2.1.1.12SS_Reader_GetLastError16

3.2.1.1.13SS_Reader_Version16

3.2.1.1.14SS_Reader_GetVersionID17

3.2.1.1.15SS_Reader_GetUserInfo17

3.2.1.1.16SS_Reader_UpdateUserInfo17

3.2.1.1.17SS_Reader_AutoRecognition17

3.2.1.1.18SS_Reader_AutoFindCard18

3.2.1.1.19ss_dev_beep18

3.2.1.1.20ss_dev_led18

3.2.1.2居民二代身份证函数18

3.2.1.2.1ss_id_ResetID2Card18

3.2.1.2.2ss_id_read_card19

3.2.1.2.3ss_id_query_name19

3.2.1.2.4ss_id_query_sex19

3.2.1.2.5ss_id_query_sexL19

3.2.1.2.6ss_id_query_folk19

3.2.1.2.7ss_id_query_folkL20

3.2.1.2.8ss_id_query_birth20

3.2.1.2.9ss_id_query_address20

3.2.1.2.10ss_id_query_number20

3.2.1.2.11ss_id_query_organ21

3.2.1.2.12ss_id_query_termbegin21

3.2.1.2.13ss_id_query_termend21

3.2.1.2.14ss_id_query_photo_data21

3.2.1.2.15ss_id_query_photo_file21

3.2.1.2.16ss_id_query_newaddress22

3.2.1.2.17ss_id_query_IDBaseInfo_text22

3.2.1.2.18ss_id_GetSAMno22

3.2.1.2.19ss_id_GetSAMStatus23

3.2.1.2.20ss_id_GetFPMsg23

3.2.1.3M1卡操作函数23

3.2.1.3.1ss_CardMifare_Reset23

3.2.1.3.2ss_CardMifare_Authentication23

3.2.1.3.3ss_CardMifare_ReadBlock24

3.2.1.3.4ss_CardMifare_WriteBlock24

3.2.1.3.5ss_CardMifare_Increment24

3.2.1.3.6ss_CardMifare_Decrement24

3.2.1.3.7ss_CardMifare_Copy24

3.2.1.3.8ss_CardMifare_GetUID25

3.2.1.4标准社保卡操作作函数25

3.2.1.4.1ss_rf_sb_FindCard25

3.2.1.4.2ss_rf_sb_ReadCardIssuers25

3.2.1.4.3ss_rf_sb_ReadCardholder26

3.2.1.4.4ss_rf_sb_ReadFingerprint26

3.2.1.5济南社保卡操作函数26

3.2.1.5.1ss_jn_sb_FindCard26

3.2.1.5.2ss_jn_sb_QuerryCardNumber26

3.2.1.64428卡操作函数27

3.2.1.6.1ss_sle_reset_card27

3.2.1.6.2ss_sle4428_read_card27

3.2.1.7磁条卡操作作函数27

3.2.1.7.1SS_CT_ReadInfo27

3.2.1.7.2SS_CT_ReadInfo_28

3.2.1.8居民健康卡基本函数（兼容山东保健证）28

3.2.1.8.1ss_reader_open28

3.2.1.8.2ss_reader_close29

3.2.1.8.3ss_rf_yl_cpu_find_card29

3.2.1.8.4ss_lib_version29

3.2.1.8.5ss_rf_yl_cpu_find_cardB29

3.2.1.8.6ss_rf_cpu_yl_read_cardInfo29

3.2.1.8.7ss_rf_cpu_yl_write_cardInfo29

3.2.1.8.8ss_rf_yl_cpu_read_issuingOrg30

3.2.1.8.9ss_rf_yl_cpu_write_issuingOrg30

3.2.1.8.10ss_rf_yl_cpu_read_demographicInfo130

3.2.1.8.11ss_rf_yl_cpu_write_demographicInfo130

3.2.1.8.12ss_rf_yl_cpu_read_hospital31

3.2.1.8.13ss_rf_yl_cpu_write_hospital31

3.2.1.8.14ss_rf_cpu_yl_read_photo31

3.2.1.8.15ss_rf_cpu_yl_write_photo31

3.2.1.8.16ss_rf_yl_cpu_read_address32

3.2.1.8.17ss_rf_yl_cpu_write_address32

3.2.1.8.18ss_rf_yl_cpu_read_linkman32

3.2.1.8.19ss_rf_yl_cpu_write_linkman32

3.2.1.8.20ss_rf_yl_cpu_read_demographicInfo233

3.2.1.8.21ss_rf_yl_cpu_write_demographicInfo233

3.2.1.8.22ss_rf_yl_cpu_read_idcardInfo33

3.2.1.8.23ss_rf_yl_cpu_write_idcardInfo33

3.2.1.8.24ss_rf_yl_cpu_read_illNum34

3.2.1.8.25ss_rf_yl_cpu_write_illNum34

3.2.1.8.26ss_rf_yl_cpu_read_BiometricIdentifier34

3.2.1.8.27ss_rf_yl_cpu_write_BiometricIdentifier34

3.2.1.8.28ss_rf_yl_cpu_read_SpecialIdentifier35

3.2.1.8.29ss_rf_yl_cpu_write_SpecialIdentifier35

3.2.1.8.30ss_rf_yl_cpu_read_AllergicReaction35

3.2.1.8.31ss_rf_yl_cpu_write_AllergicReaction35

3.2.1.8.32ss_rf_yl_cpu_read_Immunization36

3.2.1.8.33ss_rf_yl_cpu_write_Immunization36

3.2.1.8.34ss_rf_yl_cpu_read_HospitalEffectiveSign36

3.2.1.8.35ss_rf_yl_cpu_write_HospitalEffectiveSign36

3.2.1.8.36ss_rf_yl_cpu_RewriteRecord_HospitalEffectiveSign37

3.2.1.8.37ss_rf_yl_cpu_EraseRecord_HospitalEffectiveSign37

3.2.1.8.38ss_rf_yl_cpu_read_OutpatientServiceEffectiveSign37

3.2.1.8.39ss_rf_yl_cpu_write_OutpatientServiceEffectiveSign37

3.2.1.8.40ss_rf_yl_cpu_RewriteRecord_OutpatientServiceEffectiveSign38

3.2.1.8.41ss_rf_yl_cpu_EraseRecord_OutpatientServiceEffectiveSign38

3.2.1.8.42ss_rf_cpu_yl_read_HospitalInformation138

3.2.1.8.43ss_rf_cpu_yl_write_HospitalInformation138

3.2.1.8.44ss_rf_cpu_yl_read_HospitalInformation239

3.2.1.8.45ss_rf_cpu_yl_write_HospitalInformation239

3.2.1.8.46ss_rf_cpu_yl_read_OutpatientServiceInformation139

3.2.1.8.47ss_rf_cpu_yl_write_OutpatientServiceInformation139

3.2.1.8.48ss_rf_cpu_yl_read_OutpatientServiceInformation240

3.2.1.8.49ss_rf_cpu_yl_write_OutpatientServiceInformation240

3.2.1.8.50ss_rf_cpu_yl_read_FingerprintFile40

3.2.1.8.51ss_rf_cpu_yl_write_FingerprintFile41

3.2.1.8.52ss_rf_cpu_yl_GetCardUid41

3.2.1.8.53ss_rf_cpu_yl_read_HospitalInformation341

3.2.1.8.54ss_rf_cpu_yl_write_HospitalInformation341

3.2.1.8.55ss_rf_cpu_yl_read_OutpatientServiceInformation342

3.2.1.8.56ss_rf_cpu_yl_write_OutpatientServiceInformation342

3.2.1.8.57ss_rf_cpu_yl_read_OutpatientServiceInformation442

3.2.1.8.58ss_rf_cpu_yl_write_OutpatientServiceInformation442

3.2.1.8.59ss_rf_cpu_yl_read_OutpatientExpenses43

3.2.1.8.60ss_rf_cpu_yl_write_OutpatientExpenses43

3.2.1.8.61ss_rf_cpu_yl_AppcationLock_ddf143

3.2.1.8.62ss_rf_cpu_yl_AppcationUnLock_ddf143

3.2.1.8.63ss_rf_cpu_yl_AppcationLock_df0144

3.2.1.8.64ss_rf_cpu_yl_AppcationUnLock_df0144

3.2.1.8.65ss_rf_cpu_yl_AppcationLock_df0244

3.2.1.8.66ss_rf_cpu_yl_AppcationUnLock_df0244

3.2.1.8.67ss_rf_cpu_yl_AppcationLock_df0344

3.2.1.8.68ss_rf_cpu_yl_AppcationUnLock_df0345

3.2.1.8.69ss_rf_cpu_yl_CardLock45

3.2.1.8.70ss_rf_cpu_yl_read_PayInfoFile45

3.2.1.8.71ss_rf_cpu_yl_write_PayInfoFile45

3.2.1.8.72ss_rf_VerifyPINSAM145

3.2.1.8.73ss_rf_ResetSAM1AndVerifyPIN46

3.2.1.8.74ss_rf_cpu_yl_read_Binaryphoto46

3.2.1.8.75ss_rf_cpu_yl_write_Binaryphoto46

3.2.1.8.76ss_rf_cup_yl_GetCardVersion46

3.2.1.8.77ss_rf_SAM_Reset46

3.2.1.8.78ss_rf_SAM_VerifyPIN47

3.2.1.8.79ss_rf_SAM_ChangePIN47

3.2.1.8.80ss_rf_SAM_Public47

3.2.1.8.81ss_rf_SAM_Terminal47

3.2.1.8.82ss_rf_SAM_PublicApp48

3.2.1.8.83ss_rf_SAM_OrgCertificate48

3.2.1.8.84ss_rf_SAM_Certificate48

3.2.1.8.85ss_rf_SAM_SM3Digest48

3.2.1.8.86ss_rf_SAM_SM2SignHash49

3.2.1.9居民健康卡高级函数49

3.2.1.9.1SS_WSB_OpenDevice49

3.2.1.9.2SS_WSB_CloseDevice49

3.2.1.9.3SS_WSB_PowerOn50

3.2.1.9.4SS_DC_PowerOff50

3.2.1.9.5SS_DC_SetSpacer50

3.2.1.9.6SS_WSB_SendAPDU50

3.2.1.9.7SS_DC_Get_Version51

3.2.1.9.8SS_WSB_VerifyPIN51

3.2.1.9.9SS_DC_ChangePIN51

3.2.1.9.10SS_DC_RSAMPublic52

3.2.1.9.11SS_DC_RSAMTerminal52

3.2.1.9.12SS_DC_RSAMPublicApp52

3.2.1.9.13SS_DC_RSAMOrgCertificate52

3.2.1.9.14SS_DC_RSAMCertificate53

3.2.1.9.15SS_WSB_RDDF1EF0553

3.2.1.9.16SS_WSB_RDDF1EF0653

3.2.1.9.17SS_WSB_RDDF1EF0754

3.2.1.9.18SS_WSB_WDDF1EF0754

3.2.1.9.19SS_WSB_RDDF1EF0854

3.2.1.9.20SS_WSB_WDDF1EF0855

3.2.1.9.21SS_WSB_RDF01EF0555

3.2.1.9.22SS_WSB_WDF01EF0555

3.2.1.9.23SS_WSB_RDF01EF0656

3.2.1.9.24SS_WSB_WDF01EF0656

3.2.1.9.25SS_WSB_RDF01EF0757

3.2.1.9.26SS_WSB_WDF01EF0757

3.2.1.9.27SS_WSB_RDF01EF0857

3.2.1.9.28SS_WSB_WDF01EF0858

3.2.1.9.29SS_WSB_RDF02EF0558

3.2.1.9.30SS_WSB_WDF02EF0559

3.2.1.9.31SS_WSB_RDF02EF0659

3.2.1.9.32SS_WSB_WDF02EF0659

3.2.1.9.33SS_WSB_RDF02EF0760

3.2.1.9.34SS_WB_WDF02EF0760

3.2.1.9.35SS_WSB_RDF02EF0860

3.2.1.9.36SS_WSB_WDF02EF0861

3.2.1.9.37SS_WSB_SM3Digest61

3.2.1.9.38SS_WSB_SM2SignHash61

3.2.1.9.39SS_WSB_RDF03EF0562

3.2.1.9.40SS_WSB_WDF03EF0562

3.2.1.9.41SS_WSB_EDF03EF0562

3.2.1.9.42SS_WSB_RDF03EF0663

3.2.1.9.43SS_WSB_WDF03EF0663

3.2.1.9.44SS_WSB_EDF03EF0663

3.2.1.9.45SS_DC_RSign_DF03EE0063

3.2.1.9.46SS_DC_RDF03EE0064

3.2.1.9.47SS_DC_WDF03EE0064

3.2.1.9.48SS_DC_RSign_DF03ED0065

3.2.1.9.49SS_DC_RDF03ED0065

3.2.1.9.50SS_DC_WDF03ED0065

3.2.1.9.51SS_WSB_RDF03EE0066

3.2.1.9.52SS_WSB_WDF03EE0066

3.2.1.9.53SS_WSB_RDF03ED0066

3.2.1.9.54SS_WSB_WDF03ED0067

3.2.1.10指纹采集比对67

3.2.1.10.1SS_ZW_Init67

3.2.1.10.2SS_ZW_Close68

3.2.1.10.3SS_ZW_GetErrorInfo68

3.2.1.10.4SS_ZW_GetFPBmpData68

3.2.1.10.5SS_ZW_GetCharFromSensor68

3.2.1.10.6SS_ZW_Match2Char68

3.2.1.10.7SS_ZW_GetCharFromBMP68

3.2.1.10.8SS_ZW_MatchCharFromSensor68

3.2.1.10.9MPS_*69

4附录70

4.1门诊、住院记录Tag定义70

1终端简介

SS728M05是一款支持身份证、社保卡、居民健康卡、磁条卡等多种卡类型的多合一的读写终端，支持USB通讯，采用模块化设计，适用于医院等发卡行业。

1.1主要功能

名称

性能说明

非接触式卡

支持符合IS014443-4协议的TYPEA智能卡和TYPEB智能卡；

二次开发

提供进行业务系统的二次开发。

软件开发包

含有DEMO程序，开发说明书，开发库。

PSAM卡接口

同时可附加3个符合GSM11.11的Sim的卡尺寸SAM卡座。

操作系统

支持WindowsXp/7/8/8.1；WindwosServer2003/2008等操作系统。

与PC通讯类型

USB通讯。

1.2主要技术指标

参数

指标

射频谐振频率

13.56MHz土25Hz

SAM卡通讯速率

9600/38400

工作电流

≤400mA

外形尺寸

185×115×58（长×宽×高）单位：

mm

工作温度

0℃～50℃

工作湿度

≤93％，>20%

电磁兼容性

符合GB9254-2008中相应级别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

信息校验和出错

-11

SAM卡没有插入

3.1.2居民健康卡（兼容山东保健证）错误代码

表格2定义了居民健康卡（兼容山东保健证）错误代码

错误代码

说明

-63

sm2获取哈希数据失败

-64

sm3获取哈希数据失败

-65

计算过程密钥错误

-66

SAM卡选择文件错误

-67

SAM卡校验PIN失败

-68

SAM卡没有插入

-201

没有寻卡医联卡

-202

没有连接设备

-203

内部认证失败

-204

选择文