mhCardReader/江苏省人社一体化接口规范说明书_社会保障卡用卡集成商接口规范.md

江苏省人社一体化接口规范说明书_社会保障卡用卡集成商接口规范

2.1 "读基本信息"函数

2.1.1 iReadCardBas "读基本信息"

2.1.1.1 函数定义

读基本信息接口函数定义见表 1。在进行任何社保卡操作前，应先调用此函数。

表 1 读基本信息接口函数定义

项目	内容
函数名称	读基本信息
语法	long iReadCardBas(int iType, char *pOutInfo)
功能描述	选择社保卡社会保障系统环境后，通过 PSAM 卡对社保卡进行内部认证，通过后将卡内的基本信息读出返回。

参数说明

序号	参数	输入/输出	类型	长度（十进制）	含义
1	iType	IN	整数	4	操作卡的类型
2	pOutInfo	OUT	字符串	1024	读出数据或返回错误信息

返回值： 0 表示成功；非 0 表示失败。

2.1.1.2 参数说明

（1）输入参数 iType

表示执行本函数时操作卡的类型，定义如下：

• 1-接触式操作卡
• 2-非接触式操作卡
• 3-自动寻卡，接触式操作卡优先
• 4-自动寻卡，非接触式操作卡优先

（2）输出参数 pOutInfo

当函数执行成功时，该输出参数为读出的社保卡基本信息各数据项，依次为： 发卡地区行政区划代码（卡识别码前 6 位）、社会保障号码、卡号、卡识别码、姓名、卡复位信息（仅取历史字节）、规范版本、发卡日期、卡有效期、终端机编号、终端设备号、省人员识别号。

各数据项之间以"|"分割，且最后一个数据项以"|"结尾。

成功示例：

639900|111111198101011110|X00000019|639900D15600000500BF7C7A48FB4966|张三|00814E43238697159900BF7C7A|1.00|20101001|20201001|410100813475|终端设备号|JSZ000301833|

当函数执行失败时，该输出参数为错误信息描述。

注： 当没有终端设备号时，终端设备号返回空字符串；没有省人员识别号，返回空字符串。