二代身份證閱讀機具開發手冊

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);

說

明：讀閱讀器安全模塊號

參

數：無

返 回 值：閱讀器安全模塊號

注：適用于檢測有沒有閱讀器連接，或者只能使用指定閱讀器的場合。

-->