居民健康卡应用接口技术规范XXXX-12-0117841.docx
居民健康康卡应用接口口技术规范范北京冠新新医卫软软件科技技有限公公司20155年12月目录目录2前言41适用范范围52规范性性引用文文件53术语和和定义553.1居居民健康康卡 Ressideentss Heealtth CCardd53.2CCPU卡卡53.3卡卡片操作作系统（COS） Card Operating System53.4加加密算法法 CCrypptoggrapphicc Allgorrithhm53.5对对称加密密算法 Syymmeetriic CCrypptoggrapphicc Allgorrithhm63.6非非对称加加密算法法 AAsymmmettricc Crrypttogrraphhic Alggoriithmm63.7密密钥 Keyy63.8对对称密钥钥 SSymmmetrric Keyy63.9非非对称密密钥 Asyymmeetriic KKey663.100公钥 Pubblicc Keey63.111私钥 Priivatte KKey663.122数字签签名 Diggitaal SSignnatuure663.133SM22算法73.144SM33算法74缩略语语85应用模模型96接口函函数1006.1设设备管理理126.2用用户卡读读写1336.3卡卡算法服服务2776.4错错误码定定义299附录A VC程程序用例例301设备管管理3112用户卡卡读写3323卡算法法服务553附录B555前言本规范涉涉及的数数据项定定义、命命令数据据符合卫卫生部定定义的居居民健康康卡系列列规范。本规范涉涉及的密密码算法法按照国国家密码码管理部部门的要要求使用用。本规范依依据居居民健康康卡技术术规范，居民健康卡应用规范，居民健康卡安全存取模块(SAM)卡规范，居民健康卡安全存取模块(SAM)卡命令集，居民健康卡用户卡命令集，结合医疗服务和用户管理业务流程，描述定义居民健康卡中数据存取访问接口。1 适用范围围本文确定定居民健健康卡中中数据存存取的应应用编程程接口。基于符合规范的设备如（读写机具、SAM卡、用户卡）以及居民健康卡应用规范的用户卡中的定义的特定数据项，依据居民健康卡在医疗业务，用户管理等流程中的应用，描述定义所需接口函数、参数数据类型、以及接口的调用方式。2 规范性引引用文件件下列文件件中的条条款通过过本规范范的引用用而成为为本规范范的条款款居民健健康卡技技术规范范居民健健康卡应应用规范范居民健健康卡安安全存取取模块(SAMM)卡规规范居民健健康卡安安全存取取模块(SAMM)卡命命令集居民健健康卡用用户卡命命令集以下术语语和定义义适用于于本规范范。3 术语和定定义3.1 居民健康康卡 Ressideentss Heealtth CCardd居民健康康卡是中中华人民民共和国国居民拥拥有的，在在医疗卫卫生服务务活动中中用于身身份识别别，满足足健康信信息存储储，实现现跨地区区和跨机机构就医医、数据据交换和和费用结结算的基基础载体体，是计计算机可可识别的的CPUU卡。3.2 CPU卡卡带有中央央处理器器（CPPU）、存存储单元元以及卡卡片操作作系统的的集成电电路卡。3.3 卡片操作作系统（COS） Card Operating SystemCPU卡卡芯片中中存储和和运行的的，以保保护应用用数据和和程序的的机密性性和完整整性，控控制CPPU卡芯芯片与外外界信息息交换为为目的的的嵌入式式软件。3.4 加密算法法 CCrypptoggrapphicc Allgorrithhm为了隐藏藏或显现现数据信信息内容容的变换换算法。3.5 对称加密密算法 Syymmeetriic CCrypptoggrapphicc Allgorrithhm加密密钥钥可以从从解密密密钥中推推算出来来，反过过来也成成立，在在大多数数算法中中加/解密密密钥是相相同的。3.6 非对称加加密算法法 AAsymmmettricc Crrypttogrraphhic Alggoriithmm加密算法法的加密密密钥和和解密密密钥是不不一样的的，不能能由一个个密钥推推导出另另一个密密钥。3.7 密钥 Keyy加密转换换中控制制操作的的符号序序列。3.8 对称密钥钥 SSymmmetrric Keyy在对称加加密算法法中使用用的密钥钥。3.9 非对称密密钥 Asyymmeetriic KKey在非对称称加密算算法中使使用的密密钥，包包括公钥钥和私钥钥。3.10 公钥 Pubblicc Keey在一个实实体使用用的非对对称密钥钥对中可可以被公公众使用用的密钥钥。在数数字签名名方案中中，公钥钥用于验验证。3.11 私钥 Priivatte KKey在一个实实体使用用的非对对称密钥钥对中仅仅被该实实体使用用的密钥钥。在数数字签名名方案中中，私钥钥用于签签名。3.12 数字签名名 DDigiitall Siignaaturre对数据的的一种非非对称加加密变换换。该变变换可以以使数据据接收方方确认数数据的来来源和完完整性，保保护数据据发送方方发出和和接收方方收到的的数据不不被第三三方篡改改，也保保护数据据发送方方发出的的数据不不被接收收方篡改改。3.13 SM2算算法SM2 alggoriithmm ，一一种国家家商用密密码非对对称密码码算法，密密钥长度度为2556比特特。3.14 SM3算算法SM3 alggoriithmm ，一一种国家家商用密密码密码码杂凑算算法，输输出长度度为2556比特特。4 缩略语下列缩略略语适用用于本规规范： 缩略语中文名英文名0-9 AA-F十六进制制数字API应用编程程接口Appllicaatioon PProggrammminng IInteerfaaceAPDUU应用协议议数据单单元Appllicaatioon PProttocool DDataa UnnitPKI公钥基础础设施Publlic Keyy InnfraastrructtureePIN个人身份份识别码码Perssonaal IIdenntifficaatioon NNumbberan字母数字字型Alphhanuumerricans特殊字母母数字型型Alphhanuumerric Speeciaalb二进制BinaaryBER基本编码码规则Basiic EEncoodinng RRuleescn压缩数字字Comppresssedd NuumerricDDF目录定义义文件Direectoory Deffiniitioon FFileeDF专用文件件Dediicatted FilleEF基本文件件Elemmenttaryy FiileFCI文件控制制信息Filee Coontrrol InfformmatiionFID文件标识识符Filee IddenttifiierIC集成电路路Inteegraatedd CiircuuitISO 国际标准准化组织织Inteernaatioonall Orrgannizaatioon ffor StaandaardiizattionnMAC报文鉴别别代码Messsagee Auutheentiicattionn CoodeMF 主控文件件Mastter FilleSAM安全存取取模块Secuure Acccesss MoodulleTLV标签、长长度、值值Tag Lenngthh VValuue5 应用模型型根据居民民健康卡卡应用规规范，卡卡中存放放了卡片片基本信信息，用用户个人人基本信信息，联联系人信信息、医医学警示示生物标标识信息息，住院院信息、门门诊记录录信息以以及相应应的证书书签名信信息。总总共记录录的数据据项有3380多多个类别别，这些些数据项项分布在在卡中不不同目录录下不同同的文件件中。卡卡中不同同的数据据文件，根根据其存存放数据据的不同同，具有有不同的的读写权权限。具具体请参参见居居民健康康卡安全全存取模模块（SAMM）卡技术术规范附附录表A4 密钥配配置表。要读写居居民健康康卡，需需要使用用符合卫卫生部颁颁布的相相关规范范的读写写机具和和SAMM卡，完完成读写写数据所所需要的的权限控控制，在在读取特特定数据据前，需需要根据据其所在在文件不不同，依依据密钥钥配置表表去获取取外部认认证所需需要的密密钥标识识用途，密密钥版本本等信息息。然后后通过发发送指令令到SAAM卡进进行密钥钥分散，使使用SMM1算法法加密数数据取得得SAMM卡计算算外部认认证需要要的认证证数据，再发送给用户卡完成外部认证以取得相应的权限，此后再根据所读取的字段所在文件、记录号等信息进行数据读写。为了简化化上层应应用的开开发，读读写接口口将这一一过程进进行了封封装，应应用开发发者只需需要通过过接口规规范提供供的读写写函数，设设置所需需读写居居民健康康卡中的的单个或或多个数数据项，就就可以完完成数据据的读写写操作。这样应用用层就可以不不需要关关心读写写机具、用用户卡、SSAM卡卡之间的的交互，只只需要针针对所需需要数据据完成业业务流程程的设计计开发。6 接口函数数接口函数数列表如如下：函数名功能备注iDOppenPPortt打开设备备返回设备备操作句句柄iDClloseePorrt关闭设备备PoweerOnn设备复位位返回复位位信息SenddAPDDU发送指令令iVerrifyyPINN验证PIIN校验SAAM卡PPINiChaangee_Piin修改PIIN修改SAAM卡PPINiReaaderr_SAAM_PPubllic读取SAAM卡公公共信息息该函数取取得SAAM卡片片公共信信息文件件iReaaderr_SAAM_TTermminaal读取SAAM卡片片终端信信息该函数取取得SAAM卡片片的终端端信息文文件iReaaderr_SAAM_PPubllicAApp读取SAAM公共共应用信信息该函数取取得SAAM卡片片的居民民健康卡卡应用的的公共信信息文件件iReaaderr_SAAM_OOrgCCerttifiicatte读取SAAM卡上上的健康康卡发卡卡机构证证书该函数取取得SAAM卡片片的居民民健康卡卡发卡机机构证书书文件iReaaderr_SAAM_CCerttifiicatte读取SAAM卡的的机构证证书该函数取取得SAAM卡片片的SAAM卡机机构证书书iR_DDDF11EF005Innfo读取卡中中DDFF1EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(发卡卡机构基基本数据据文件)iR_DDDF11EF006Innfo读取卡中中DDFF1EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(持卡卡人基本本信息数数据文件件)iR_DDDF11EF007Innfo读取卡中中DDFF1EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(照片片)iR_DDDF11EF008Innfo读取卡中中DDFF1EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(有效效期等)iW_DDDF11EF008Innfo写入卡中中DDFF1EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(有效效期等)iR_DDF011EF005Innfo读取卡中中DF01EEF055中的数数据根据函数数各参数数读取卡卡中数据据(地址址信息文文件)iW_DDF011EF005Innfo写入卡中中DDFF1EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(地址址信息文文件)iR_DDF011EF006Innfo读取卡中中DF001EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(联系系人信息息文件)iW_DDF011EF006Innfo写入卡中中DF001EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(联系系人信息息文件)iR_DDF011EF007Innfo读取卡中中DF001EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(职业业婚姻信信息文件件)iW_DDF011EF007Innfo写入卡中中DF001EFF07中中的数据据根据函数数各参数数写入卡卡中数据据(职业业婚姻信信息文件件)iR_DDF011EF008Innfo读取卡中中DF001EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(证件件记录信信息文件件)iW_DDF011EF008Innfo写入卡中中DF001EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(证件件记录信信息文件件)iR_DDF022EF005Innfo读取卡中中DF002EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(临床床基本数数据文件件)iW_DDF022EF005Innfo写入卡中中DF002EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(临床床基本数数据文件件)iR_DDF022EF006Innfo读取卡中中DF002EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(特殊殊信息数数据文件件)iW_DDF022EF006Innfo写入卡中中DF002EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(特殊殊信息数数据文件件)iR_DDF022EF007Innfo读取卡中中DF002EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(过敏敏基本数数据文件件)iW_DDF022EF007Innfo写入卡中中DF002EFF07中中的数据据根据函数数各参数数写入卡卡中数据据(过敏敏基本数数据文件件)iR_DDF022EF008Innfo读取卡中中DF002EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(免疫疫基本数数据文件件)iW_DDF022EF008Innfo写入卡中中DF002EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(免疫疫基本数数据文件件)iR_DDF033EF005Innfo读取卡中中DF003EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(住院院信息索索引文件件)iW_DDF033EF005Innfo写入卡中中DF003EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(住院院信息索索引文件件，将住住院有效效标识更更改为00x000)iEraase_DF003EFF05IInfoo擦出卡中中DF003EFF05中中的数据据住院信息息索引文文件，将将住院有有效标识识更改为为0xFFFiR_DDF033EF006Innfo读取卡中中DF003EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(门诊诊信息索索引文件件)iW_DDF033EF006Innfo写入卡中中DF003EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(门诊诊信息索索引文件件，将门门诊有效效标识更更改为00x000)iEraase_DF003EFF06IInfoo擦出卡中中DF003EFF06中中的数据据门诊信息息索引文文件，将将门诊有有效标识识更改为为0xFFFiR_DDF03EEEInnfo读取卡中中DF03EEE中的的数据根据函数数各参数数读取卡卡中数据据(住院院信息文文件)iW_DDF03EEEInnfo写入卡中中DF03EEE中的的数据根据函数数各参数数写入卡卡中数据据(住院院信息文文件)iR_DDF03EEDInnfo读取卡中中DF033ED中的的数据根据函数数各参数数读取卡卡中数据据(门诊诊信息文文件)iW_DDF03EEDInnfo写入卡中中DF03EEE中的的数据根据函数数各参数数写入卡卡中数据据(门诊诊信息文文件)SM3DDigeestSM3哈哈希对输入数数据分组组进行哈哈希运算算SM2SSignnHasshSM2算算法数据据签名对哈希数数据进行行SM22算法加加密6.1 设备管理理6.1.1 概述设备管理理函数主主要是检检测设备备，连接接关闭设设备，检检测卡，给给卡上下下电等操操作。这这些操作作都封装装在以下下两个函函数中。函数名功能备注iDOppenPPortt打开设备备返回设备备操作句句柄iDClloseePorrt关闭设备备PoweerOnn设备复位位返回复位位信息SenddAPDDU发送指令令6.1.2 打开设备备函数原型型HANDDLE WINNAPIIiDOOpennPorrt ()功能描述述打开读写写机具，等等待下一一步操作作。返回值成功返回回0，失败败，返回回ERRROR_OPEEN_FFAILLED。备注为防止句句柄资源源泄漏，要要求打开开一次必必须关闭闭一次。6.1.3 关闭设备备函数原型型int WIINAPPIiDCClossePoort()返回值成功，返返回0，失失败返回回相应的的错误码码。6.1.4 设备复位位函数原型型int _sstdccalll PoowerrOn(HANNDLEE hDDev ,intt sllot, chhar * AATR)功能描述述返回复位位信息。参数hDevvIN 设备备句柄。slottIN 卡槽槽号0xx01用用户卡 0x111 PPSAMM卡ATROUTT 复复位信息息返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.5 发送指令令函数原型型int _sstdccalll SeendAAPDUU (HANDDLE hDeev,unsiigneed ccharr byySloot,unsiigneed ccharr * pbyyC_CCommmandd,unsiigneed llongg byyLenn,unsiigneed ccharr * pbyyR_CCommmandd,int * ppnRees)功能描述述发送指令令。参数hDevvIN 设备备句柄。bySllotIN 卡槽槽号。pbyCC_CoommaandIN 指令令数据。byLeenIN 指令令长度pbyRR_Coommaand,OUTT 返返回数据据pnReesOUTT 返返回数据据长度返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.6 PSAMM卡PIIN认证证函数原型型int _sstdccalll iVVeriifyPPIN(HANNDLEE hDDev,chaar * PIIN)功能描述述认证PSSAM卡卡PINN参数hDevvIN 设备备句柄。PININ PSSAM卡卡PINN。返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.7 PSAMM卡PIIN修改改函数原型型int _sstdccalll iCChannge_Pinn(HAANDLLE hhDevv,chhar *olldPiin, chaar *newwPinn)功能描述述修改PSSAM卡卡PINN参数hDevvIN 设备备句柄。oldPPinIN PSSAM卡卡原有的的PINN。newPPinIN PSSAM卡卡新的PPIN。返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.8 读取SAAM卡片片公共信信息文件件函数原型型int _sstdccalll iRReadder_SAMM_Puubliic (HANNDLEE hDDev,chaar* inffo)功能描述述取得SAAM卡片片公共信信息文件件参数hDevvIN 设备备句柄。infooOUTT 获取取的卡片片公共信信息返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.9 读取SAAM卡片片的终端端信息文文件函数原型型int _sstdccalll iRReadder_SAMM_Teermiinall (HHANDDLE hDeev,ccharr* iinfoo)功能描述述取得SAAM卡片片卡片的的终端信信息文件件参数hDevvIN 设备备句柄。infooOUTT 获取取的卡片片终端信信息返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.10 读取SAAM卡片片的居民民健康卡卡应用的的公共信信息文件件函数原型型int _sstdccalll iRReadder_SAMM_PuubliicAppp(HHANDDLE hDeev,ccharr* iinfoo)功能描述述取得SAAM卡片片的居民民健康卡卡应用的的公共信信息文件件参数hDevvIN 设备备句柄。infooOUTT 获取取的居民民健康卡卡应用的的公共信信息返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.11 读取SAAM卡片片的居民民健康卡卡发卡机机构证书书文件函数原型型int _sstdccalll iRReadder_SAMM_OrrgCeertiificcatee(HAANDLLE hhDevv,chhar* innfo)功能描述述取得SAAM卡片片的居民民健康卡卡发卡机机构证书书文件参数hDevvIN 设备备句柄。infooOUTT 获取取的居民民健康卡卡发卡机机构证书书返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.1.12 读取SAAM卡片片的SAAM卡机机构证书书函数原型型int _sstdccalll iRReadder_SAMM_Ceertiificcatee(HAANDLLE hhDevv,chhar* innfo)功能描述述SAM卡卡片的SSAM卡卡机构证证书参数hDevv参数infooOUTT 获取取的SAAM卡机机构证书书返回值返回值：成功，返返回0，失失败返回回相应的的错误码码。6.2 用户卡读读写函数名功能备注iR_DDDF11EF005Innfo读取卡中中DDFF1EFF05中中的数据据根据函数数各参数读取取卡中数数据(发发卡机构构基本数数据文件件)iR_DDDF11EF006Innfo读取卡中中DDFF1EFF06中中的数据据根据函数数各参数读读取卡中中数据(持卡人人基本信信息数据据文件)iR_DDDF11EF007Innfo读取卡中中DDFF1EFF07中中的数据据根据函数数各参数读读取卡中中数据(照片)iR_DDDF11EF008Innfo读取卡中中DDFF1EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(有效效期等)iW_DDDF11EF008Innfo写入卡中中DDFF1EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(有效效期等)iR_DDF011EF005Innfo读取卡中中DF01EEF055中的数数据根据函数数各参数数读取卡卡中数据据(地址址信息文文件)iW_DDF011EF005Innfo写入卡中中DDFF1EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(地址址信息文文件)iR_DDF011EF006Innfo读取卡中中DF001EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(联系系人信息息文件)iW_DDF011EF006Innfo写入卡中中DF001EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(联系系人信息息文件)iR_DDF011EF007Innfo读取卡中中DF001EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(职业业婚姻信信息文件件)iW_DDF011EF007Innfo写入卡中中DF001EFF07中中的数据据根据函数数各参数数写入卡卡中数据据(职业业婚姻信信息文件件)iR_DDF011EF008Innfo读取卡中中DF001EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(证件件记录信信息文件件)iW_DDF011EF008Innfo写入卡中中DF001EFF08中的数数据根据函数数各参数数写入卡卡中数据据(证件件记录信信息文件件)iR_DDF022EF005Innfo读取卡中中DF002EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(临床床基本数数据文件件)iW_DDF022EF005Innfo写入卡中中DF002EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(临床床基本数数据文件件)iR_DDF022EF006Innfo读取卡中中DF002EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(特殊殊信息数数据文件件)iW_DDF022EF006Innfo写入卡中中DF002EFF06中中的数据据根据函数数各参数数写入卡卡中数据据(特殊殊信息数数据文件件)iR_DDF022EF007Innfo读取卡中中DF002EFF07中中的数据据根据函数数各参数数读取卡卡中数据据(过敏敏基本数数据文件件)iW_DDF022EF007Innfo写入卡中中DF002EFF07中中的数据据根据函数数各参数数写入卡卡中数据据(过敏敏基本数数据文件件)iR_DDF022EF008Innfo读取卡中中DF002EFF08中中的数据据根据函数数各参数数读取卡卡中数据据(免疫疫基本数数据文件件)iW_DDF022EF008Innfo写入卡中中DF002EFF08中中的数据据根据函数数各参数数写入卡卡中数据据(免疫疫基本数数据文件件)iR_DDF033EF005Innfo读取卡中中DF003EFF05中中的数据据根据函数数各参数数读取卡卡中数据据(住院院信息索索引文件件)iW_DDF033EF005Innfo写入卡中中DF003EFF05中中的数据据根据函数数各参数数写入卡卡中数据据(住院院信息索索引文件件，将住住院有效效标识更更改为00x000)iEraase_DF003EFF05IInfoo擦出卡中中DF003EFF05中中的数据据住院信息息索引文文件，将将住院有有效标识识更改为为0xFFFiR_DDF033EF006Innfo读取卡中中DF003EFF06中中的数据据根据函数数各参数数读取卡卡中数据据(门诊诊信息索索引文件件)iW_DDF033EF006Innfo写入卡中中DF033EF006中的的数据根据函数数各参数数写入卡卡中数据据(门诊诊信息索索引文件件，将门门诊有效效标识更更改为00x000)iEraase_DF003EFF06IInfoo擦出卡中中DF003EFF06中中的数据据门诊信息息索引文文件，将将门诊有有效标识识更改为为0xFFFiR_DDF03EEEInnfo读取卡中中DF03EEE中的的数据根据函数数各参数数读取卡卡中数据据(住院院信息文文件)iW_DDF03EEEInnfo写入卡中中DF03EEE中的的数据根据函数数各参数数写入卡卡中数据据(住院院信息文文件)iR_DDF03EEDInnfo读取卡中中DF03EDD中的数数据根据函数数各参数数读取卡卡中数据据(门诊诊信息文文件)iW_DDF03EEDInnfo写入卡中中DF03EEE中的的数据根据函数数各参数数写入卡卡中数据据(门诊诊信息文文件)6.2.1 读发卡机机构基本本数据文文件接口口函数原型型int _sstdccalll iRR_DDDF1EEF055Inffo(HANDDLE hDeev,charr * KLBB,charr * GFBBB,charr * FKJJGMCC,charr * FKJJGDMM,charr * FKJJGZSS,charr * FKSSJ,charr * KH,charr * AQMM, charr * XPXXLH, charr * YYCCSDMM)功能描述述根据用户户设置的的函数参参数，读读取用户户卡内相相关字段段数据。参数hDevvIN 设备备句柄。KLBOUTT 卡卡类别代代码。GFBBBOUTT 规规范版本本。FKJGGMCOUTT 发发卡机构构名称。FKJGGDMOUTT 发发卡机构构代码FKJGGZSOUTT 发发卡机构构证书FKSJJOUTT 发发卡时间间KHOUTT 卡卡号AQMOUTT 安安全码XPXLLHOUTT 芯芯片序列列号YYCSSDMOUTT 应应用城市市代码返回值如果成功功，返回回0；否否则返回回错误代代码。备注发卡时间间为YYYYYMMMDDD格式；卡号，与与居民身身份证号号或者证证件号码码一致。6.2.2 读持卡人人基本信信息数据据文件接接口函数原型型int _sstdccalll iRR_DDDF1EEF066Inffo(HANDDLE hDeev,ccharr * XM,ccharr * XB,ccharr * MZ,ccharr * CSRRQ,ccharr * SFZZH)功能描述述根据用户户设置的的函数参参数，读读取用户户卡内相相关字段段数据。参数hDevvIN 设备备句柄。XMOUTT 姓姓名。XBOUTT 性性别代码码。MZOUTT 民民族代码码。CSRQQOUTT 出出生日期期。SFZHHOUTT 居居民身份份证号。返回值如果成功功，返回回0；否否则返回回错误代代码。6.2.3 读照片文文件接口口函数原型型int _sstdccalll iRR_DDDF1EEF077Inffo(HHANDDLE hDeev,BBYTEE * ZHAAOPIIAN)功能描述述根据用户户设置的的函数参参数，读读取用户户卡内相相关字段段数据。参数hDevvIN 设备备句柄。ZHAOOPIAANOUTT 照照片。返回值如果成功功，返回回0；否则则返回错错误代码码。6.2.4 读写有效效期等文件接口口读有效期期等文件接接口：函数原型型int _sstdccallliR_DDFF1EFF08IInfoo(HANDDLE hDeev,KYXXQ, BRDDH1, BRDDH2, YLFFYZFFFS11, YLFFYZFFFS22, YLFFYZFFFS33)功能描述述根据用户户设置的的函数参参数，读读取用户户卡内相相关字段段数据。参数hDevvIN 设备备句柄。KYXQQOUTT 卡卡有效期期。BRDHH1OUTT 本本人电话话1。BRDHH2OUTT 本本人电话话2。YLFYYZFFFS1OUTT 医医疗费用用支付方方式1YLFYYZFFFS2OUTT 医医疗费用用支付方方式2YLFYYZFFFS3OUTT 医医疗费用用支付方方式3返回值如果成功功，返回回0；否否则返回回错误代代码。备注卡有效期期为YYYYYMMMDDD格式。写有效期期等文件接接口：函数原型型int _sstdccallliW_DDDF1EEF088Inffo (HANDDLE hDeev,KYXXQ, BRDDH1, BRDDH2, YLFFYZFFFS11, YLFFYZFFFS22, YLFFYZFFFS33)功能描述述根据用户户设置的的函数参参数，写入用户户卡内相相关字段段数据。参数hDevvIN 设备备句柄。KYXQQIN 卡有有效期。BRDHH1IN 本人人电话11。BRDHH2IN 本人人电话22。YLFYYZFFFS1IN 医疗疗费用支支付方式式1YLFYYZFFFS2IN 医疗疗费用支支付方式式2YLFYYZFFFS3IN 医疗疗费用支支付方式式3返回值如果成功功，返回回0；否否则返回回错误代代码。备注卡有效期期为YYYYYMMMDDD格式；相关字字段数据据长度参参见：附附录B。6.2.5 读写地址址信息文文件接口口读地址信信息文件件接口：函数原型型int _sstdccalll iRR_DFF01EEF055Inffo(HANDDLE hDeev,chaar * DZZLB11,chaar * DZZ1,chaar * DZZLB22,chaar * DZZ2)功能描述述根据用户户设置的的函数参参数，读读取用户户卡内相相关字段段数据。参数hDevvIN 设备备句柄。DZLBB1OUTT 地地址类别别1。DZ1OUTT 地地址1。DZLBB2OUTT 地地址类别别2。DZ2OUTT 地地
