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

## 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|
```

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

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