華騰永泰OCX讀卡器接口

華騰永泰OCX讀卡器接口驅動安裝程序用于網頁的控件，安裝后能夠啟用旅店管理系統(tǒng)的設備。根據屏幕上出現(xiàn)的提示進行安裝，安裝后需要重啟IE瀏覽器。壓縮包內附1.7.2+1.7.4最新版。

第二代身份證接口規(guī)范（華騰永泰）

OCX

控件描述：

1

檢測設備連接是否正確：

GetState() 

返回值：

數(shù)字

’

0

’

-

表示設備正常；

’

<0

’

 -

表示設備錯誤

, 

對應錯誤碼表

: 

-4: 

未檢測到設備

說明：

檢測設備連接是否正確，不正確則返回不正確原因。

2

讀取二代證信息方法：

ReadCard() 

返回值：

數(shù)字

: 

’

0

’

-

表示讀卡成功；

’

<0

’

 -

表示讀卡失敗，

對應錯誤碼表

: 

-4:

未檢測到設備

-6:

未檢測到卡

說明：

通過網頁按鈕等事件觸發(fā)讀卡方式。

3

讀取二代證信息方法

(

循環(huán)讀卡

)

：

Start ()

。

返回值：

數(shù)字

’

0

’

-

表示讀卡成功；

’

<0

’

 -

表示讀卡失敗，對應錯誤碼表；

說明：

自動讀卡方式，用戶身份證放在設備上即自動讀卡，該接口可選做。

4

屬性

Name/NameL 

返回值：

字符串

(BStr)

。

Name 

–

卡片中儲存的姓名。

應屆生求職季寶典 開啟你的職場征途

簡歷撰寫 筆試真題 面試攻略 專業(yè)技能指導 公務員專區(qū)

NameL 

–

處理過的姓名。

說明：

區(qū)別在于

Name

中兩個字名稱中間有空格，

NameL

則去除了空格。

如：

Name = 

張

三

  NameL = 

張三

5

屬性

Sex/SexL 

返回值：

字符串

(BStr)

。

Sex 

–

卡片中儲存的性別代碼。

SexL 

–

處理過的性別。

說明：

區(qū)別在于

Sex

返回國家標準的性別代碼，

SexL

則根據

2005

年國家標準翻譯出性

別。如：

Sex = 1  SexL = 

男

6

屬性

Nation/NationL 

返回值：

字符串

(BStr)

。

Nation 

–

卡片中儲存的民族代碼。

NationL 

–

處理過的民族。

說明：

區(qū)別在于

Nation

返回國家標準的民族代碼，

NationL

則根據

2005

年國家標準翻

譯出民族。如：

Nation = 01  NationL = 

漢族

7

屬性

Born/BornL 

返回值：

字符串

(BStr)

。

Born 

–

卡片中儲存的出生日期。

BornL 

–

處理過的出生日期。

說明：

區(qū)別在于

Born

返回簡化的出生日期，

BornL

則將出生日期格式化

（

YYYYMMDD

）

。

如：

Born = 1967-03-12  BornL = 1967-03-12

8

屬性

Address 

返回值：

字符串

(BStr)

。

說明：

身份證中儲存的住址。

9

屬性

CardNo 

返回值：

字符串

(BStr)

。

說明：

身份證中儲存的身份號碼。

10

屬性

Police 

返回值：

字符串

(BStr)

。

說明：

身份證中儲存的簽發(fā)機關。

11

屬性

Activity/

 ActivityL

返回值：

字符串

(BStr)

。

Activity 

–

卡片中儲存的有效期限。

ActivityL 

–

處理過的有效期限。

說明：

區(qū)別在于

Activity

返回簡化的有效期限

，

ActivityL

則將有效期限格式化

。如：

Activity = 1967120119771201

 ActivityL = 1967-12-01-1977-12-01

12

屬性

ActivityLFrom 

返回值：

字符串

(BStr)

。

說明：

返回有效期起始時間。如：

ActivityLFrom = 2007-12-01 

13

屬性

ActivityLTo 

返回值：

字符串

(BStr)

。

說明：

返回有效期失效時間。如：

ActivityLTo = 2017-12-01

14

屬性

PhotoPath 

設置照片存放路徑：

字符串（

BStr

）

說明：

缺省不設置

PhotoPath

，

PhotoPath

在缺省或設置為空的情況下，

表示照片不用

保存在客戶端設備上。

15

屬性

SamId 

返回值：

字符串

(BStr)

。

說明：

返回設備的序列號。如：

SamId

 = 5-1-20060724-128629-3849269270

16

接口

GetPhotoBuffer() 

返回值：

字符串

(BStr) 

說明：

返回照片數(shù)據流，具體為

WLT

文件數(shù)據流進行

BASE64

編碼得到的字符串。

注：

1.

圖片大小不能大于

20k

。

2.

控件大小為照片大小獲得圖像就顯示圖像，獲取失敗圖像位置顯示“照片”

2

字。

3.

照片文件名稱（

Str

）要以身份證號命名。

17

身份證圖像信息的打印方法：

PrintImage(int nX,int nY) 

返回值：

0 

成功

1 

失敗

說明：

提供打印接口，能直接在各種大小的紙張上打印

1:1

的身份證圖像；圖像信息

包括身份證正反面雙面的原始背景、文字、照片等，需盡可能的接近原始效

果。正面圖像跟反面圖像上下并排。

參數(shù)說明：

nX

、

nY 

輸入值，單位

mm

，打印的起始坐標，紙張的左上角坐標定位（

0

，

0

）

18

獲得照片復印件正反面信息：

GetFaceJpgBase64

（

int iface

）

返回值：

字符串

(BStr) 

說明：

返回照片正反面數(shù)據流，具體為

jpg

文件數(shù)據流進行

BASE64

編碼得到的字符

串。

參數(shù)說明：

iface

輸入值，

0

雙面信息，

1

為正面信息，

2

為反面信息

控件

CAB

包使用方法說明：

1

、用

IdrOcx.cab

的目的：

當客戶在訪問網站時，在客戶端自動下載

IdrOcx.dll

插件。

2

、決方案介紹：

這種自動下載功能，

是

Internet Explorer

的

5.X

以上版本提供的一種基于

Active 

X

的方式。

IE

瀏覽器會通過網頁里面的

<object>

標簽所標示的軟件名稱以及版本，

檢測當前系統(tǒng)中是否裝有該軟件，

若裝了，

則檢測版本是否比它老，

若當前系統(tǒng)

中沒有該軟件或者版本不夠新時，

IE

就會自動安裝該軟件，

當然在安裝軟件之前，

它會有一個安全認證的過程。

（請在瀏覽器中將該網頁設置為受信任的站點，

控

件方可進行安裝）

3

、使用方法：

1

）、在網頁上發(fā)布

IdrOcx.dll

插件。

需要使用的

HTML

元素是：

<object></object>

。

先將我們的操作中涉及的它的

屬性介紹如下：

clsid

：生成的類在

windows

中的編號

, 

IdrOcx

控件的

clsid

為

220C3AD1-5E9D-4B06-870F-E34662E2DFEA

。

codebase

：指定需要下載的軟件地址及其版本。

具體寫法參照

test.html

。比如我們可以在網頁中寫入：

<OBJECT Name="GT2ICROCX" width="607" height="400" 

CLASSID="CLSID: 220C3AD1-5E9D-4B06-870F-E34662E2DFEA" 

CODEBASE="IdrOcx.cab#version=1,0,1,1"> 

</OBJECT> 

在未安裝

ActiveX 

控件的機器上，如果控件

<OBJECT> 

標記中沒有指定

CODEBASE

，將不能下載該控件，因而也不能顯示。

因此，一定要在控件的

<OBJECT> 

標記中指定

CODEBASE 

屬性，并指向正確的控件下載位置。例如

將

test.html

測試頁面和

IdrOcx.CAB

發(fā)布到服務器同一目錄下，

訪問

test.html

測試頁

面，如果能夠正常下載該控件則說明

CODEBASE

設置正確（訪問之前先確定完

成如下述步驟的

IE

安全設置）。控件安裝完成后，會在

c:\windows\system32

目錄

下解開

idrocx.dll,termb.dll,bmp2jpgdll.dll,wltrs.dll

四個文件。

4

、如果客戶端使用

USB

端口連接閱讀機具，請在客戶端安裝

USB

驅動。

USB

驅動在控件的安裝包或機具配套光盤中有提供，請網站設計者通過在網

頁上提供

USB

驅動下載鏈接或者其他方式為網站訪問者提供

USB

驅動。

控件卸載

由于

OCX

只能提供自動安裝方式，卸載需要手工進行，為了客戶方便，我們

制作了自動卸載的批處理命令。

Uninstallocx.bat 

regsvr32 

–

u c:\windows\system32\idrocx.dll 

del c:\windows\system32\idrocx.dll 

del c:\windows\system32\termb.dll 

del c:\windows\system32\bmp2jpgdll.dll 

del c:\windows\system32\wltrs.dll