《居民健康卡应用接口技术规范XXXX-12-01.docx》由会员分享,可在线阅读,更多相关《居民健康卡应用接口技术规范XXXX-12-01.docx(73页珍藏版)》请在三一办公上搜索。
1、居民健康卡应用接口技术规范北京冠新医卫软件科技有限公司2015年12月目录目录2前言41适用范围52规范性引用文件53术语和定义53.1居民健康卡 Residents Health Card53.2CPU卡53.3卡片操作系统(COS) Card Operating System53.4加密算法 Cryptographic Algorithm53.5对称加密算法 Symmetric Cryptographic Algorithm63.6非对称加密算法 Asymmetric Cryptographic Algorithm63.7密钥 Key63.8对称密钥 Symmetric Key63.9非对
2、称密钥 Asymmetric Key63.10公钥 Public Key63.11私钥 Private Key63.12数字签名 Digital Signature63.13SM2算法73.14SM3算法74缩略语85应用模型96接口函数106.1设备管理126.2用户卡读写136.3卡算法服务276.4错误码定义29附录A VC程序用例301设备管理312用户卡读写323卡算法服务53附录B55前言本规范涉及的数据项定义、命令数据符合卫生部定义的居民健康卡系列规范。本规范涉及的密码算法按照国家密码管理部门的要求使用。本规范依据居民健康卡技术规范,居民健康卡应用规范,居民健康卡安全存取模块(S
3、AM)卡规范,居民健康卡安全存取模块(SAM)卡命令集,居民健康卡用户卡命令集,结合医疗服务和用户管理业务流程,描述定义居民健康卡中数据存取访问接口。1 适用范围本文确定居民健康卡中数据存取的应用编程接口。基于符合规范的设备如(读写机具、SAM卡、用户卡)以及居民健康卡应用规范的用户卡中的定义的特定数据项,依据居民健康卡在医疗业务,用户管理等流程中的应用,描述定义所需接口函数、参数数据类型、以及接口的调用方式。2 规范性引用文件下列文件中的条款通过本规范的引用而成为本规范的条款居民健康卡技术规范居民健康卡应用规范居民健康卡安全存取模块(SAM)卡规范居民健康卡安全存取模块(SAM)卡命令集居民
4、健康卡用户卡命令集以下术语和定义适用于本规范。3 术语和定义3.1 居民健康卡 Residents Health Card居民健康卡是中华人民共和国居民拥有的,在医疗卫生服务活动中用于身份识别,满足健康信息存储,实现跨地区和跨机构就医、数据交换和费用结算的基础载体,是计算机可识别的CPU卡。3.2 CPU卡 带有中央处理器(CPU)、存储单元以及卡片操作系统的集成电路卡。3.3 卡片操作系统(COS) Card Operating SystemCPU卡芯片中存储和运行的,以保护应用数据和程序的机密性和完整性,控制CPU卡芯片与外界信息交换为目的的嵌入式软件。3.4 加密算法 Cryptogra
5、phic Algorithm为了隐藏或显现数据信息内容的变换算法。3.5 对称加密算法 Symmetric Cryptographic Algorithm加密密钥可以从解密密钥中推算出来,反过来也成立,在大多数算法中加/解密密钥是相同的。3.6 非对称加密算法 Asymmetric Cryptographic Algorithm加密算法的加密密钥和解密密钥是不一样的,不能由一个密钥推导出另一个密钥。3.7 密钥 Key加密转换中控制操作的符号序列。3.8 对称密钥 Symmetric Key在对称加密算法中使用的密钥。3.9 非对称密钥 Asymmetric Key在非对称加密算法中使用的密钥
6、,包括公钥和私钥。3.10 公钥 Public Key在一个实体使用的非对称密钥对中可以被公众使用的密钥。在数字签名方案中,公钥用于验证。3.11 私钥 Private Key在一个实体使用的非对称密钥对中仅被该实体使用的密钥。在数字签名方案中,私钥用于签名。3.12 数字签名 Digital Signature 对数据的一种非对称加密变换。该变换可以使数据接收方确认数据的来源和完整性,保护数据发送方发出和接收方收到的数据不被第三方篡改,也保护数据发送方发出的数据不被接收方篡改。3.13 SM2算法SM2 algorithm ,一种国家商用密码非对称密码算法,密钥长度为256比特。3.14 S
7、M3算法SM3 algorithm ,一种国家商用密码密码杂凑算法,输出长度为256比特。4 缩略语下列缩略语适用于本规范: 缩略语中文名英文名0-9 A-F十六进制数字API应用编程接口Application Programming InterfaceAPDU应用协议数据单元Application Protocol Data UnitPKI公钥基础设施Public Key InfrastructurePIN个人身份识别码Personal Identification Numberan字母数字型Alphanumericans特殊字母数字型Alphanumeric Specialb二进制Bina
8、ryBER基本编码规则Basic Encoding Rulescn压缩数字Compressed NumericDDF目录定义文件Directory Definition FileDF专用文件Dedicated FileEF基本文件Elementary FileFCI文件控制信息File Control InformationFID文件标识符File IdentifierIC集成电路Integrated CircuitISO 国际标准化组织International Organization for StandardizationMAC报文鉴别代码Message Authentication C
9、odeMF 主控文件Master FileSAM安全存取模块Secure Access ModuleTLV标签、长度、值Tag Length Value5 应用模型根据居民健康卡应用规范,卡中存放了卡片基本信息,用户个人基本信息,联系人信息、医学警示生物标识信息,住院信息、门诊记录信息以及相应的证书签名信息。总共记录的数据项有380多个类别,这些数据项分布在卡中不同目录下不同的文件中。卡中不同的数据文件,根据其存放数据的不同,具有不同的读写权限。具体请参见居民健康卡安全存取模块(SAM)卡技术规范附录表A4 密钥配置表。要读写居民健康卡,需要使用符合卫生部颁布的相关规范的读写机具和SAM卡,完
10、成读写数据所需要的权限控制,在读取特定数据前,需要根据其所在文件不同,依据密钥配置表去获取外部认证所需要的密钥标识用途,密钥版本等信息。然后通过发送指令到SAM卡进行密钥分散,使用SM1算法加密数据取得SAM卡计算外部认证需要的认证数据,再发送给用户卡完成外部认证以取得相应的权限,此后再根据所读取的字段所在文件、记录号等信息进行数据读写。为了简化上层应用的开发,读写接口将这一过程进行了封装,应用开发者只需要通过接口规范提供的读写函数,设置所需读写居民健康卡中的单个或多个数据项,就可以完成数据的读写操作。这样应用层就可以不需要关心读写机具、用户卡、SAM卡之间的交互,只需要针对所需要数据完成业务
11、流程的设计开发。6 接口函数接口函数列表如下:函数名功能备注iDOpenPort打开设备返回设备操作句柄iDClosePort关闭设备PowerOn设备复位返回复位信息SendAPDU发送指令iVerifyPIN验证PIN校验SAM卡PINiChange_Pin修改PIN修改SAM卡PINiReader_SAM_Public读取SAM卡公共信息该函数取得SAM卡片公共信息文件iReader_SAM_Terminal读取SAM卡片终端信息该函数取得SAM卡片的终端信息文件iReader_SAM_PublicApp读取SAM公共应用信息该函数取得SAM卡片的居民健康卡应用的公共信息文件iReade
12、r_SAM_OrgCertificate读取SAM卡上的健康卡发卡机构证书该函数取得SAM卡片的居民健康卡发卡机构证书文件iReader_SAM_Certificate读取SAM卡的机构证书该函数取得SAM卡片的SAM卡机构证书iR_DDF1EF05Info读取卡中DDF1EF05中的数据根据函数各参数读取卡中数据(发卡机构基本数据文件)iR_DDF1EF06Info读取卡中DDF1EF06中的数据根据函数各参数读取卡中数据(持卡人基本信息数据文件)iR_DDF1EF07Info读取卡中DDF1EF07中的数据根据函数各参数读取卡中数据(照片)iR_DDF1EF08Info读取卡中DDF1EF
13、08中的数据根据函数各参数读取卡中数据(有效期等)iW_DDF1EF08Info写入卡中DDF1EF08中的数据根据函数各参数写入卡中数据(有效期等)iR_DF01EF05Info读取卡中DF01EF05中的数据根据函数各参数读取卡中数据(地址信息文件)iW_DF01EF05Info写入卡中DDF1EF05中的数据根据函数各参数写入卡中数据(地址信息文件)iR_DF01EF06Info读取卡中DF01EF06中的数据根据函数各参数读取卡中数据(联系人信息文件)iW_DF01EF06Info写入卡中DF01EF06中的数据根据函数各参数写入卡中数据(联系人信息文件)iR_DF01EF07Info
14、读取卡中DF01EF07中的数据根据函数各参数读取卡中数据(职业婚姻信息文件)iW_DF01EF07Info写入卡中DF01EF07中的数据根据函数各参数写入卡中数据(职业婚姻信息文件)iR_DF01EF08Info读取卡中DF01EF08中的数据根据函数各参数读取卡中数据(证件记录信息文件)iW_DF01EF08Info写入卡中DF01EF08中的数据根据函数各参数写入卡中数据(证件记录信息文件)iR_DF02EF05Info读取卡中DF02EF05中的数据根据函数各参数读取卡中数据(临床基本数据文件)iW_DF02EF05Info写入卡中DF02EF05中的数据根据函数各参数写入卡中数据(
15、临床基本数据文件)iR_DF02EF06Info读取卡中DF02EF06中的数据根据函数各参数读取卡中数据(特殊信息数据文件)iW_DF02EF06Info写入卡中DF02EF06中的数据根据函数各参数写入卡中数据(特殊信息数据文件)iR_DF02EF07Info读取卡中DF02EF07中的数据根据函数各参数读取卡中数据(过敏基本数据文件)iW_DF02EF07Info写入卡中DF02EF07中的数据根据函数各参数写入卡中数据(过敏基本数据文件)iR_DF02EF08Info读取卡中DF02EF08中的数据根据函数各参数读取卡中数据(免疫基本数据文件)iW_DF02EF08Info写入卡中DF
16、02EF08中的数据根据函数各参数写入卡中数据(免疫基本数据文件)iR_DF03EF05Info读取卡中DF03EF05中的数据根据函数各参数读取卡中数据(住院信息索引文件)iW_DF03EF05Info写入卡中DF03EF05中的数据根据函数各参数写入卡中数据(住院信息索引文件,将住院有效标识更改为0x00)iErase_DF03EF05Info擦出卡中DF03EF05中的数据住院信息索引文件,将住院有效标识更改为0xFFiR_DF03EF06Info读取卡中DF03EF06中的数据根据函数各参数读取卡中数据(门诊信息索引文件)iW_DF03EF06Info写入卡中DF03EF06中的数据根
17、据函数各参数写入卡中数据(门诊信息索引文件,将门诊有效标识更改为0x00)iErase_DF03EF06Info擦出卡中DF03EF06中的数据门诊信息索引文件,将门诊有效标识更改为0xFFiR_DF03EEInfo读取卡中DF03EE中的数据根据函数各参数读取卡中数据(住院信息文件)iW_DF03EEInfo写入卡中DF03EE中的数据根据函数各参数写入卡中数据(住院信息文件)iR_DF03EDInfo读取卡中DF03ED中的数据根据函数各参数读取卡中数据(门诊信息文件)iW_DF03EDInfo写入卡中DF03EE中的数据根据函数各参数写入卡中数据(门诊信息文件)SM3DigestSM3哈
18、希对输入数据分组进行哈希运算SM2SignHashSM2算法数据签名对哈希数据进行SM2算法加密6.1 设备管理6.1.1 概述设备管理函数主要是检测设备,连接关闭设备,检测卡,给卡上下电等操作。这些操作都封装在以下两个函数中。函数名功能备注iDOpenPort打开设备返回设备操作句柄iDClosePort关闭设备PowerOn设备复位返回复位信息SendAPDU发送指令6.1.2 打开设备函数原型HANDLE WINAPI iDOpenPort ()功能描述打开读写机具,等待下一步操作。返回值成功返回0,失败,返回ERROR_OPEN_FAILED。备注为防止句柄资源泄漏,要求打开一次必须关
19、闭一次。6.1.3 关闭设备函数原型int WINAPIiDClosePort ()返回值成功,返回0,失败返回相应的错误码。6.1.4 设备复位函数原型int _stdcall PowerOn(HANDLE hDev ,int slot, char * ATR)功能描述返回复位信息。参数hDevIN 设备句柄。slotIN 卡槽号 0x01用户卡 0x11 PSAM卡ATROUT 复位信息返回值返回值:成功,返回0,失败返回相应的错误码。6.1.5 发送指令函数原型int _stdcall SendAPDU (HANDLE hDev,unsigned char bySlot,unsigned
20、 char * pbyC_Command,unsigned long byLen,unsigned char * pbyR_Command,int * pnRes )功能描述发送指令。参数hDevIN 设备句柄。bySlotIN 卡槽号。pbyC_CommandIN 指令数据。byLenIN 指令长度pbyR_Command,OUT 返回数据pnResOUT 返回数据长度返回值返回值:成功,返回0,失败返回相应的错误码。6.1.6 PSAM卡PIN认证函数原型int _stdcall iVerifyPIN(HANDLE hDev,char * PIN)功能描述认证PSAM卡PIN参数hDevI
21、N 设备句柄。PININ PSAM卡PIN。返回值返回值:成功,返回0,失败返回相应的错误码。6.1.7 PSAM卡PIN修改函数原型int _stdcall iChange_Pin (HANDLE hDev, char *oldPin, char *newPin)功能描述修改PSAM卡PIN参数hDevIN 设备句柄。oldPinIN PSAM卡原有的PIN。newPinIN PSAM卡新的PIN。返回值返回值:成功,返回0,失败返回相应的错误码。6.1.8 读取SAM卡片公共信息文件函数原型int _stdcall iReader_SAM_Public (HANDLE hDev, char
22、* info)功能描述取得SAM卡片公共信息文件参数hDevIN 设备句柄。infoOUT 获取的卡片公共信息返回值返回值:成功,返回0,失败返回相应的错误码。6.1.9 读取SAM卡片的终端信息文件函数原型int _stdcall iReader_SAM_Terminal (HANDLE hDev, char* info)功能描述取得SAM卡片卡片的终端信息文件参数hDevIN 设备句柄。infoOUT 获取的卡片终端信息返回值返回值:成功,返回0,失败返回相应的错误码。6.1.10 读取SAM卡片的居民健康卡应用的公共信息文件函数原型int _stdcall iReader_SAM_Pub
23、licApp (HANDLE hDev, char* info)功能描述取得SAM卡片的居民健康卡应用的公共信息文件参数hDevIN 设备句柄。infoOUT 获取的居民健康卡应用的公共信息返回值返回值:成功,返回0,失败返回相应的错误码。6.1.11 读取SAM卡片的居民健康卡发卡机构证书文件函数原型int _stdcall iReader_SAM_OrgCertificate (HANDLE hDev, char* info)功能描述取得SAM卡片的居民健康卡发卡机构证书文件参数hDevIN 设备句柄。infoOUT 获取的居民健康卡发卡机构证书返回值返回值:成功,返回0,失败返回相应的错
24、误码。6.1.12 读取SAM卡片的SAM卡机构证书函数原型int _stdcall iReader_SAM_Certificate (HANDLE hDev, char* info)功能描述SAM卡片的SAM卡机构证书参数hDev参数infoOUT 获取的SAM卡机构证书返回值返回值:成功,返回0,失败返回相应的错误码。6.2 用户卡读写函数名功能备注iR_DDF1EF05Info读取卡中DDF1EF05中的数据根据函数各参数读取卡中数据(发卡机构基本数据文件)iR_DDF1EF06Info读取卡中DDF1EF06中的数据根据函数各参数读取卡中数据(持卡人基本信息数据文件)iR_DDF1EF
25、07Info读取卡中DDF1EF07中的数据根据函数各参数读取卡中数据(照片)iR_DDF1EF08Info读取卡中DDF1EF08中的数据根据函数各参数读取卡中数据(有效期等)iW_DDF1EF08Info写入卡中DDF1EF08中的数据根据函数各参数写入卡中数据(有效期等)iR_DF01EF05Info读取卡中DF01EF05中的数据根据函数各参数读取卡中数据(地址信息文件)iW_DF01EF05Info写入卡中DDF1EF05中的数据根据函数各参数写入卡中数据(地址信息文件)iR_DF01EF06Info读取卡中DF01EF06中的数据根据函数各参数读取卡中数据(联系人信息文件)iW_D
26、F01EF06Info写入卡中DF01EF06中的数据根据函数各参数写入卡中数据(联系人信息文件)iR_DF01EF07Info读取卡中DF01EF07中的数据根据函数各参数读取卡中数据(职业婚姻信息文件)iW_DF01EF07Info写入卡中DF01EF07中的数据根据函数各参数写入卡中数据(职业婚姻信息文件)iR_DF01EF08Info读取卡中DF01EF08中的数据根据函数各参数读取卡中数据(证件记录信息文件)iW_DF01EF08Info写入卡中DF01EF08中的数据根据函数各参数写入卡中数据(证件记录信息文件)iR_DF02EF05Info读取卡中DF02EF05中的数据根据函数
27、各参数读取卡中数据(临床基本数据文件)iW_DF02EF05Info写入卡中DF02EF05中的数据根据函数各参数写入卡中数据(临床基本数据文件)iR_DF02EF06Info读取卡中DF02EF06中的数据根据函数各参数读取卡中数据(特殊信息数据文件)iW_DF02EF06Info写入卡中DF02EF06中的数据根据函数各参数写入卡中数据(特殊信息数据文件)iR_DF02EF07Info读取卡中DF02EF07中的数据根据函数各参数读取卡中数据(过敏基本数据文件)iW_DF02EF07Info写入卡中DF02EF07中的数据根据函数各参数写入卡中数据(过敏基本数据文件)iR_DF02EF08
28、Info读取卡中DF02EF08中的数据根据函数各参数读取卡中数据(免疫基本数据文件)iW_DF02EF08Info写入卡中DF02EF08中的数据根据函数各参数写入卡中数据(免疫基本数据文件)iR_DF03EF05Info读取卡中DF03EF05中的数据根据函数各参数读取卡中数据(住院信息索引文件)iW_DF03EF05Info写入卡中DF03EF05中的数据根据函数各参数写入卡中数据(住院信息索引文件,将住院有效标识更改为0x00)iErase_DF03EF05Info擦出卡中DF03EF05中的数据住院信息索引文件,将住院有效标识更改为0xFFiR_DF03EF06Info读取卡中DF0
29、3EF06中的数据根据函数各参数读取卡中数据(门诊信息索引文件)iW_DF03EF06Info写入卡中DF03EF06中的数据根据函数各参数写入卡中数据(门诊信息索引文件,将门诊有效标识更改为0x00)iErase_DF03EF06Info擦出卡中DF03EF06中的数据门诊信息索引文件,将门诊有效标识更改为0xFFiR_DF03EEInfo读取卡中DF03EE中的数据根据函数各参数读取卡中数据(住院信息文件)iW_DF03EEInfo写入卡中DF03EE中的数据根据函数各参数写入卡中数据(住院信息文件)iR_DF03EDInfo读取卡中DF03ED中的数据根据函数各参数读取卡中数据(门诊信息
30、文件)iW_DF03EDInfo写入卡中DF03EE中的数据根据函数各参数写入卡中数据(门诊信息文件)6.2.1 读发卡机构基本数据文件接口函数原型int _stdcall iR_DDF1EF05Info(HANDLE hDev,char * KLB,char * GFBB,char * FKJGMC,char * FKJGDM,char * FKJGZS,char * FKSJ,char * KH,char * AQM, char * XPXLH, char * YYCSDM )功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。KLBOUT 卡类别代码。G
31、FBBOUT 规范版本。FKJGMCOUT 发卡机构名称。FKJGDMOUT 发卡机构代码FKJGZSOUT 发卡机构证书FKSJOUT 发卡时间KHOUT 卡号AQMOUT 安全码XPXLHOUT 芯片序列号YYCSDMOUT 应用城市代码返回值如果成功,返回0;否则返回错误代码。备注发卡时间为YYYYMMDD格式;卡号,与居民身份证号或者证件号码一致。6.2.2 读持卡人基本信息数据文件接口函数原型int _stdcall iR_DDF1EF06Info(HANDLE hDev,char * XM,char * XB,char * MZ,char * CSRQ,char * SFZH )功
32、能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。XMOUT 姓名。XBOUT 性别代码。MZOUT 民族代码。CSRQOUT 出生日期。SFZHOUT 居民身份证号。返回值如果成功,返回0;否则返回错误代码。6.2.3 读照片文件接口函数原型int _stdcall iR_DDF1EF07Info(HANDLE hDev,BYTE * ZHAOPIAN)功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。ZHAOPIANOUT 照片。返回值如果成功,返回0;否则返回错误代码。6.2.4 读写有效期等文件接口读有效期等文件接口
33、:函数原型int _stdcall iR_DDF1EF08Info(HANDLE hDev,KYXQ, BRDH1, BRDH2, YLFYZFFS1, YLFYZFFS2, YLFYZFFS3 )功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。KYXQOUT 卡有效期。BRDH1OUT 本人电话1。BRDH2OUT 本人电话2。YLFYZFFS1OUT 医疗费用支付方式1YLFYZFFS2OUT 医疗费用支付方式2YLFYZFFS3OUT 医疗费用支付方式3返回值如果成功,返回0;否则返回错误代码。备注卡有效期为YYYYMMDD格式。 写有效期等文件接口
34、:函数原型int _stdcall iW_DDF1EF08Info (HANDLE hDev,KYXQ, BRDH1, BRDH2, YLFYZFFS1, YLFYZFFS2, YLFYZFFS3 )功能描述根据用户设置的函数参数,写入用户卡内相关字段数据。参数hDevIN 设备句柄。KYXQIN 卡有效期。BRDH1IN 本人电话1。BRDH2IN 本人电话2。YLFYZFFS1IN 医疗费用支付方式1YLFYZFFS2IN 医疗费用支付方式2YLFYZFFS3IN 医疗费用支付方式3返回值如果成功,返回0;否则返回错误代码。备注卡有效期为YYYYMMDD格式;相关字段数据长度参见:附录B。
35、6.2.5 读写地址信息文件接口读地址信息文件接口:函数原型int _stdcall iR_DF01EF05Info(HANDLE hDev,char * DZLB1,char * DZ1,char * DZLB2,char * DZ2 )功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。DZLB1OUT 地址类别1。DZ1OUT 地址1。DZLB2OUT 地址类别2。DZ2OUT 地址2。返回值如果成功,返回0;否则返回错误代码。写地址信息文件接口:函数原型int _stdcall iW_DF01EF05Info(HANDLE hDev,char * DZ
36、LB1,char * DZ1,char * DZLB2,char * DZ2 )功能描述根据用户设置的函数参数,写入用户卡内相关字段数据。参数hDevIN 设备句柄。DZLB1IN 地址类别1。DZ1IN 地址1。DZLB2IN 地址类别2。DZ2IN 地址2。返回值如果成功,返回0;否则返回错误代码。备注相关字段数据长度参见:附录B。6.2.6 读写联系人信息文件接口读联系人信息文件接口:函数原型int _stdcall iR_DF01EF06Info(HANDLE hDev,char * LXRXM1,char * LXRGX1,char * LXRDH1,char * LXRXM2,ch
37、ar * LXRGX2,char * LXRDH2,char * LXRXM3,char * LXRGX3,char * LXRDH3 )功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。LXRXM1OUT 联系人姓名1。LXRGX1OUT 联系人关系代码1。LXRDH1OUT 联系人电话1。LXRXM2OUT 联系人姓名2。LXRGX2OUT 联系人关系代码2。LXRDH2OUT 联系人电话2。LXRXM3OUT 联系人姓名3。LXRGX3OUT 联系人关系代码3。LXRDH3OUT 联系人电话3。返回值如果成功,返回0;否则返回错误代码。写联系人信息文件
38、接口:函数原型int _stdcall iW_DF01EF06Info(HANDLE hDev,char * LXRXM1,char * LXRGX1,char * LXRDH1,char * LXRXM2,char * LXRGX2,char * LXRDH2,char * LXRXM3,char * LXRGX3,char * LXRDH3 )功能描述该接口根据传入的参数,写入卡内对应的各字段数据。参数hDevIN 设备句柄。LXRXM1IN 联系人姓名1。LXRGX1IN 联系人关系代码1。LXRDH1IN 联系人电话1。LXRXM2IN 联系人姓名2。LXRGX2IN 联系人关系代码2
39、。LXRDH2IN 联系人电话2。LXRXM3IN 联系人姓名3。LXRGX3IN 联系人关系代码3。LXRDH3IN 联系人电话3。返回值如果成功,返回0;否则返回错误代码。备注相关字段数据长度参见:附录B。6.2.7 读写职业婚姻信息文件接口读职业婚姻信息文件接口:函数原型int _stdcall iR_DF01EF07Info(HANDLE hDev,char * WHCD,char * HYZK,char * ZY )功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。WHCDOUT 文化程度代码。HYZKOUT 婚姻状况代码。ZYOUT 职业代码。返
40、回值如果成功,返回0;否则返回错误代码。写职业婚姻信息文件接口:函数原型int _stdcall iW_DF01EF07Info(HANDLE hDev,char * WHCD,char * HYZK,char * ZY )功能描述根据用户设置的函数参数,写入用户卡内相关字段数据。参数hDevIN 设备句柄。WHCDIN 文化程度代码。HYZKIN 婚姻状况代码。ZYIN 职业代码。返回值如果成功,返回0;否则返回错误代码。备注相关字段数据长度参见:附录B。6.2.8 读写证件记录信息文件接口读证件记录信息文件接口:函数原型int _stdcall iR_DF01EF08Info(HANDLE
41、 hDev,char * ZJLB,char * ZJHM, char * JKDAH, char * XNHZH )功能描述根据用户设置的函数参数,读取用户卡内相关字段数据。参数hDevIN 设备句柄。ZJLBOUT 证件类别代码。ZJHMOUT 证件号码。JKDAHOUT 健康档案号。XNHZH OUT 新农合证号。返回值如果成功,返回0;否则返回错误代码。写证件记录信息文件接口:函数原型int _stdcall iW_DF01EF08Info(HANDLE hDev,char * ZJLB,char * ZJHM, char * JKDAH, char * XNHZH )功能描述根据用户设置的函数参数,写入用户卡内相关字段数据。参数hDevIN 设备句柄。ZJLBIN 证件类别代码。ZJHMIN 证件号码。JKDAHIN 健康档案号。XNHZH IN 新农合证号。