二代身份证阅读机具开发手册

ActiveX 控件 classid：clsid:454C18E2-8B7D-43C6-8C17-B1825B49D7DE

Websocket：端口 1818    接口函数说明

1.1. 读身份证卡内信息

原

型：LONG ReadCard(LONG nPort, LPCTSTR szPhotoPath)

说

明：读取二代证卡内信息。

参

数：nPort：1001

参

数：szPhotoPath：图片全路径

返

回：OCX:返回 1 和非 1

Websocket：返回 json

具体如下表格：

OCX 返 回 值：

值

说明

1

正确

非 1

读取身份证信息失败

Websocket 返回值：

Json

说明

result

1:正确 非 1：读取身份证信息失败

Mode

模块安全编码

Name

姓名

Sex

性别

Folk

民族

Address

个人地址信息

BirthDate

出生日信息

IdNo

身份证号码

Agency

个人发证机关信息

Valid

身份证个人有效日期信息

PhotoB64

头像 bmp 图片的数据流

FingerB64

指纹数据

1.2. 获得身份证信息个人姓名

原

型：BSTR GetName(void)；

说

明：获取身份证个人姓名信息。

返 回 值：个人姓名信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确获得身份证个人姓名信息

1.3. 获得身份证个人性别信息（汉字）

原

型：BSTR GetSex(void)；

说

明：本函数用于获取身份证个人性别信息。

返 回 值：个人性别信息，”男”、”女”、”未知”等。

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人性别信息

1.4. 获得身份证信息个人民族（汉字）

原

型：BSTR GetFolk(void)；

说

明：本函数用于获取身份证个人民族信息。

返 回 值：个人民族信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人民族信息

1.5. 获得身份证个人身份证号信息

原

型：BSTR GetCode(void)；

说

明：本函数用于获取身份证个人身份证号信息。

返 回 值：个人身份证号信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人身份证号信息

1.6. 获得身份证个人出生年信息

原

型：BSTR GetBirthYear(void)；

说

明：本函数用于获取身份证个人出生年信息。

返 回 值：个人出生年信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人出生年信息

1.7. 获得身份证个人出生月信息

原

型：BSTR GetBirthMonth(void)；

说

明：本函数用于获取身份证个人出生月信息。

返 回 值：个人出生月信息注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人出生月信息

1.8. 获得身份证个人获得出生日信息

原

型：BSTR GetBirthDay(void)；

说

明：本函数用于获取身份证个人获得出生日信息。

返 回 值：个人出生日信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人获得出生日信息

1.9. 获得身份证个人地址信息

原

型：BSTR GetAddress(void)；

说

明：本函数用于获取身份证个人地址信息。

返 回 值：个人地址信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人地址信息

1.10.获得身份证个人发证机关信息

原

型：BSTR GetAgency(void)；

说

明：本函数用于获取身份证个人发证机关信息。

返 回 值：个人发证机关信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人发证机关信息

1.11.获得身份证个人有效日期信息

原

型：BSTR GetValid(void)；

说

明：本函数用于获取身份证个人有效日期信息。

返 回 值：个人有效日期信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人有效日期信息

1.12.获得身份证个人有效开始日期信息

原

型：BSTR GetValidBegin(void)；

说

明：本函数用于获取身份证个人有效开始日期信息。

返 回 值：个人有效开始日期信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人有效日期信息

1.13.获得身份证个人有效结束日期信息

原

型：BSTR GetValidEnd(void)；

说

明：本函数用于获取身份证个人有效结束日期信息。

返 回 值：个人有效结束 日期信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人有效日期信息

1.14.获得身份证相片 BMP 格式的 Base64 编码

原

型：BSTR GetPhotobuf (void)；

说

明：本函数用于获取身份证相片 BMP 格式的 Base64 编码信息。

参数: 无

返 回 值：身份证相片 Base64 编码信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人相片信息

1.15.获得身份证相片 JPG 格式的 Base64 编码

原

型：BSTR GetJPGPhotobuf (void)；

说

明：本函数用于获取身份证相片 JPG 格式的 Base64 编码信息。

参数: 无

返 回 值：身份证相片 Base64 编码信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人相片信息

1.16.获取指纹数据 Base64 编码

原

型：BSTR GetFPData(void);

说

明：本函数用于获取指纹数据。

参

数: 无

返 回 值：指纹数据 Base64 编码信息

注：必须在 ReadCard 函数调用并返回成功后，才能正确得到身份证个人指纹信息1.17.读阅读器安全模块号

原

型：BSTR GetSAMID (void);

说

明：读阅读器安全模块号

参

数：无

返 回 值：阅读器安全模块号

注：适用于检测有没有阅读器连接，或者只能使用指定阅读器的场合。

-->