用 到的库
donsee32.dll:EST-100身份证阅读器的读卡库
WltRS.dll:身份证头像的解码库
以上2个库需要放相同目录,调用donsee32.dll后,会自动调用WltRS.dll
新建工程,导入函数,需要注意结构体的使用方法
#region donsee32.dll API声明 WltRS.dll需和donsee32.dll放同一目录
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_Open(StringBuilder szDevName);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_Beep();
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_Close();
public struct SSCard_IDINFO /*社保卡信息结构体*/
{
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)]
public string name; /*姓名*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 10)]
public string sex; /*性别*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 20)]
public string nation; /*民族*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string birthday; /*出生日期(YYYYMMDD)*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string signdat; /*发证日期(YYYYMMDD)*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string validterm; /*有效日期(YYYYMMDD)*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)]
public string cardnumber; /*卡号*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)]
public string idnumber; /*社会保障号码(身份证号)*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)]
public string city; /*城市代码*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 8)]
public string cardveVrsion; /*社保卡版本*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)]
public string identityCode; /*卡识别码*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 32)]
public string szTerminalNo; /*SAM卡识别号*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 200)]
public string Other; /*其他*/
}
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ReadSSCard(int nSlotPsam, ref SSCard_IDINFO cardInfo, StringBuilder arrChMsg); /*注意结构体入参*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_iReadCardBas(int iType, StringBuilder pOutInfo);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_iReadCardBas_HSM_Step1(int iType, StringBuilder pOutInfo);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_iReadCardBas_HSM_Step2(StringBuilder pKey, StringBuilder pOutInfo);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_Version(StringBuilder pszVersion);
//############################### 读身份证 ############################################################
// 支持 0、J、I、Y 四种证件,共计18项,请根据证件类型获取对应信息
// 0:居民身份证
// J:港澳台居民居住证
// I:2017版外国人永久居留身份证
// Y:新版外国人永久居留身份证
public struct IDINFO /*身份证信息结构体*/
{
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)]
public string name; /*中文姓名: 0 J I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)]
public string ENfullname; /*英文姓名(Y时需要和Other英文姓名备用组合起来才是完整的英文姓名): I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 10)]
public string sex; /*性别: 0 I J Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 20)]
public string people; /*民族或国籍, 0 时为民族, I Y 时为国籍*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 200)]
public string address; /*地址: 0 J Y, Y 时为既往版本永居证号码 */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string birthday; /*出生日期(YYYYMMDD): 0 J I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string signdate; /*有效期开始(YYYYMMDD): 0 J I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string validterm; /*有效期结束(YYYYMMDD): 0 J I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 40)]
public string number; /*证件号码: 0 I J Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 50)]
public string organs; /*发证机关(或外国人永久居证-当次申请受理机关): 0 J I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 200)]
public string Nationality; /*国籍代码: I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 2049)]
public string Photo; /*相片原始信息: 0 J I Y */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 200)]
public string Other; /*其他 Y 时为英文姓名备用*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 24)]
public string passNu; /*通行证号码: J */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 8)]
public string signCount; /*签发数次: J */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 8)]
public string certVersion; /* I 时为证件版本号, Y 时为换证次数 */
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 6)]
public string certType; /*证件类型: 0 J I Y ,"0"居民身份证,"J"港澳台,"I"2017版永居证,"Y"新版永居证*/
[MarshalAs(UnmanagedType.ByValTStr, SizeConst = 2049)]
public string figData; /*指纹信息: 0 J */
}
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ReadIDCard(int nType, StringBuilder szPath, ref IDINFO idInfo, StringBuilder pszMsg);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ReadIDCardUid(StringBuilder pszUID);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_GetBankCardNo(StringBuilder pszBankCardNo);
/*非接卡函数*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_SetTypeA();
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ICRequest();
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ICAnticoll(StringBuilder t_pszUID);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ICSelect(byte cardType);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_PowerOnTypeA(StringBuilder pszAtr);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_SetTypeB();
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_PowerOnTypeB(StringBuilder pszAtr);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_APDUType(StringBuilder szAPDUCmd, StringBuilder pszAPDUResult);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ReadICUid(StringBuilder pszUID);//读取M1和CPU卡UID,仅限用于串口方式读取
/*非接卡函数*/
/*M1卡认证秘钥、读写函数*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_M1VerifyPass(byte nMode, byte nSecNr, StringBuilder szPassKey); /*字符串秘钥*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_M1VerifyPassHex(byte nMode, byte nSecNr, byte[] szPassKey); /*数组秘钥*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_M1Read(byte nAddr, StringBuilder pszData);
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_M1Write(byte nAddr, StringBuilder szData);
/*M1卡认证秘钥、读写函数*/
/*接触式CPU卡函数
大卡座:ICC_Slot_No:0x01
副卡:0x02
SAM1:0x11
SAM2:0x12
SAM3:0x13
SAM4:0x14
*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_PowerOn(byte nSlotNo, StringBuilder pszATR);//上电 返回数据长度 冷+热
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_ColdPowerOn(byte nSlotNo, StringBuilder pszATR);//上电 冷 返回数据长度
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_HotPowerOn(byte nSlotNo, StringBuilder pszATR);//上电 热 返回数据长度
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_PowerOff(byte nSlotNo);//下电
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_GetStatus(byte nSlotNo, ref int nStatus);//获取卡座状态
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_APDU(byte nSlotNo, StringBuilder szAPDUCmd, StringBuilder pszAPDUResult);//执行APUD
/*接触式CPU卡函数*/
/*15693卡*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_15693_Find(StringBuilder pszUID);//寻卡出来Uid
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_15693_Info(StringBuilder pszCardInfo);//用于得到卡的详细信息
/*15693卡*/
[DllImport("donsee32.dll", CallingConvention = CallingConvention.StdCall)]
static extern int Donsee_WRSerial(int nType, StringBuilder pszSerial);//读写SN,nType =0 写;nType=1 读
/*****************************************************************/
//扫码的函数DLL,不带扫码的可以不加载donseeQR32.dll
/*
long ICC_Reader_Open(char* dev_Name); //打开读卡器
long ICC_Reader_Close(long ReaderHandle); //关闭读卡器
long ICC_Reader_SetQRCodeMode(long ReaderHandle, unsigned short Mode); //设置扫码头输出模式,Mode:输出模式,1=模拟键盘主动输出,0=USB控制被动输出
long ICC_Reader_ScanCode(long ReaderHandle, int ctime, unsigned char* pCodeInfo);//开启二维码扫码
*/
//打开端口
[DllImport("donseeQR32.dll", EntryPoint = "ICC_Reader_Open")]
public static extern int ICC_Reader_Open(StringBuilder dev_Name); //dev_name=USB1
//关闭端口
[DllImport("donseeQR32.dll", EntryPoint = "ICC_Reader_Close")]
public static extern int ICC_Reader_Close(int ReaderHandle);
[DllImport("donseeQR32.dll", EntryPoint = "ICC_Reader_SetQRCodeMode")]
public static extern int ICC_Reader_SetQRCodeMode(int ReaderHandle,int Mode);
[DllImport("donseeQR32.dll", EntryPoint = "ICC_Reader_ScanCode")]
public static extern int ICC_Reader_ScanCode(int ReaderHandle,int time, byte[] pCodeInfo);
/*****************************************************************/
#endregion
读身份证调用,注意有四种不同的证件类型,需要判断证件类型后做相应的解析。
//身份证信息 *******************************************************************************************************
private void button4_Click(object sender, EventArgs e)
{
if (FormIsOpenReader.IsOpenReader != 1)
{
richTextBox_idCard_data.Text += "读卡器连接失败,请先打开设备 \r\n";
return;
}
int t_nRe = 99;
int t_nType = 1; //设置身份证读卡类型:0,文本信息;1,文本 + 照片;2,文本 + 照片 + 指纹,不读指纹读卡速度更快一些!
StringBuilder t_szPicPath = new StringBuilder("IDphoto.jpg"); //定义相片名称
StringBuilder t_arrChMsg = new StringBuilder(256);
IDINFO idInfo = new IDINFO(); //结构体
t_nRe = Donsee_ReadIDCard(t_nType, t_szPicPath, ref idInfo, t_arrChMsg); //注意结构体入参
if (t_nRe == 0)
{
Donsee_Beep();
if (idInfo.certType.ToString().Trim() == "I")//2017版外国人永居证
{
richTextBox_idCard_data.Text += "读取成功,证件类型:2017版外国人永居证\r\n";
richTextBox_idCard_data.Text += "证件类型标识:" + idInfo.certType.ToString().Trim() + "\r\n";
richTextBox_idCard_data.Text += "英文姓名:" + idInfo.ENfullname + "\r\n";
richTextBox_idCard_data.Text += "性 别:" + idInfo.sex + "\r\n";
richTextBox_idCard_data.Text += "永居证号码:" + idInfo.number + "\r\n";
richTextBox_idCard_data.Text += "国籍:" + idInfo.people + idInfo.Nationality + "\r\n";
richTextBox_idCard_data.Text += "中文姓名:" + idInfo.name + "\r\n";
richTextBox_idCard_data.Text += "有效期开始:" + idInfo.signdate + "\r\n";
richTextBox_idCard_data.Text += "有效期结束:" + idInfo.validterm + "\r\n";
richTextBox_idCard_data.Text += "出生日期:" + idInfo.birthday + "\r\n";
richTextBox_idCard_data.Text += "证件版本号:" + idInfo.certVersion + "\r\n";
richTextBox_idCard_data.Text += "申请机关代码:" + idInfo.organs + "\r\n";
if (t_nType != 0)
{
richTextBox_idCard_data.Text += "照片原始数据:" + idInfo.Photo.Substring(0, 50) + "..\r\n";
}
//外国人永居证没有指纹数据
}
else if (idInfo.certType.ToString().Trim() == "J")//港澳台居民居住证
{
richTextBox_idCard_data.Text += "读取成功,证件类型:港澳台通行证\r\n";
richTextBox_idCard_data.Text += "证件类型标识:" + idInfo.certType.ToString().Trim() + "\r\n";
richTextBox_idCard_data.Text += "姓名:" + idInfo.name + "\r\n";
richTextBox_idCard_data.Text += "性别:" + idInfo.sex + "\r\n";
richTextBox_idCard_data.Text += "出生日期:" + idInfo.birthday + "\r\n";
richTextBox_idCard_data.Text += "地址:" + idInfo.address + "\r\n";
richTextBox_idCard_data.Text += "港澳台居住证号码:" + idInfo.number + "\r\n";
richTextBox_idCard_data.Text += "签发机关:" + idInfo.organs + "\r\n";
richTextBox_idCard_data.Text += "有效期开始:" + idInfo.signdate + "\r\n";
richTextBox_idCard_data.Text += "有效期结束:" + idInfo.validterm + "\r\n";
richTextBox_idCard_data.Text += "通行证号码:" + idInfo.passNu + "\r\n";
richTextBox_idCard_data.Text += "签发次数:" + idInfo.signCount + "\r\n";
if (t_nType != 0)
{
richTextBox_idCard_data.Text += "照片原始数据:" + idInfo.Photo.Substring(0, 50) + "..\r\n";
}
if (t_nType == 2)
{
richTextBox_idCard_data.Text += "指纹原始数据:" + idInfo.figData.Substring(0, 50) + "..\r\n";
}
}
else if (idInfo.certType.ToString().Trim() == "Y")//新版外国人永居证
{
richTextBox_idCard_data.Text += "读取成功,证件类型:新版外国人永居证\r\n";
richTextBox_idCard_data.Text += "证件标识:" + idInfo.certType.ToString().Trim() + "\r\n";
richTextBox_idCard_data.Text += "中文姓名:" + idInfo.name + "\r\n";
richTextBox_idCard_data.Text += "性 别:" + idInfo.sex + "\r\n";
richTextBox_idCard_data.Text += "换证次数:" + idInfo.certVersion + "\r\n";
richTextBox_idCard_data.Text += "出生日期:" + idInfo.birthday + "\r\n";
richTextBox_idCard_data.Text += "英文姓名:" + idInfo.ENfullname + " " +idInfo.Other + "\r\n"; //注意英文姓名,包括了备用,才是完整姓名
richTextBox_idCard_data.Text += "证件号码:" + idInfo.number + "\r\n";
richTextBox_idCard_data.Text += "有效期开始:" + idInfo.signdate + "\r\n";
richTextBox_idCard_data.Text += "有效期结束:" + idInfo.validterm + "\r\n";
richTextBox_idCard_data.Text += "国籍代码:" + idInfo.people + "/" + idInfo.Nationality + "\r\n";
richTextBox_idCard_data.Text += "当次申请受理机构:" + idInfo.organs + "\r\n";
if (idInfo.address=="")
{
richTextBox_idCard_data.Text += "既往版本永居证号码:无" + "\r\n";
}
else {
richTextBox_idCard_data.Text += "既往版本永居证号码:" + idInfo.address + "\r\n";
}
if (t_nType != 0)
{
richTextBox_idCard_data.Text += "照片数据:" + idInfo.Photo.Substring(0, 50) + "..\r\n"; //原始数据2048字符,界面只显示50字符
}
}
else //(idInfo.certType.ToString().Trim() == "0") //居民身份证
{
richTextBox_idCard_data.Text += "读取成功,证件类型:居民身份证\r\n";
richTextBox_idCard_data.Text += "证件标识:" + idInfo.certType.ToString().Trim() + "\r\n";
richTextBox_idCard_data.Text += "姓 名:" + idInfo.name + "\r\n";
richTextBox_idCard_data.Text += "性 别:" + idInfo.sex + "\r\n";
richTextBox_idCard_data.Text += "名 族:" + idInfo.people + "\r\n";
richTextBox_idCard_data.Text += "出生日期:" + idInfo.birthday + "\r\n";
richTextBox_idCard_data.Text += "住 址:" + idInfo.address + "\r\n";
richTextBox_idCard_data.Text += "发证日期:" + idInfo.signdate + "\r\n";
richTextBox_idCard_data.Text += "有效日期:" + idInfo.validterm + "\r\n";
richTextBox_idCard_data.Text += "证件号码:" + idInfo.number + "\r\n";
richTextBox_idCard_data.Text += "发证机关:" + idInfo.organs + "\r\n";
richTextBox_idCard_data.Text += "其 他:" + idInfo.Other + "\r\n";
if (t_nType != 0)
{
richTextBox_idCard_data.Text += "照片数据:" + idInfo.Photo.Substring(0, 50) + "..\r\n"; //原始数据2048字符,界面只显示50字符
}
if (t_nType == 2)
{
richTextBox_idCard_data.Text += "指纹数据:" + idInfo.figData.Substring(0, 50) + "..\r\n"; //原始数据2048字符,界面只显示50字符
}
}
if (t_nType != 0) //显示照片文件
{
// pictureBox_idCard_photo.Image = Image.FromFile(t_szPicPath.ToString());
// 显示照片,这个方法二次刷卡可能不显示照片,故改用下面方法来显示照片
Image imgtmp = Image.FromFile(t_szPicPath.ToString());//这样做可以及时释放文件占用
Bitmap img = new Bitmap(imgtmp);
imgtmp.Dispose();
pictureBox_idCard_photo.Image = img;
}
}
else
{
richTextBox_idCard_data.Text += "身份证读取失败:"+ t_arrChMsg.ToString() + ",返回值:" + t_nRe + "\r\n";
}
}
读社保卡调用:
//Donsee_iReadCardBas读基本信息
//返回格式:发卡地区行政区划代码(卡识别码前6位)|社会保障号码|卡号|卡识别码|姓名|卡复位信息(仅取历史字节)|规范版本|发卡日期|卡有效期|终端机编号|终端设备号|
//返回举例:360700|360700199907151372|890642628|360700D156003335690999604657ED2D|张无忌|0081544B44869B160818107861|2.00|20180701|20280701|310000309109|65884835323437175132|
//说明:此函数读三代社保卡需要psam卡,否则返回-2201,二代社保卡可以直接读取
private void button19_Click(object sender, EventArgs e)
{
if (FormIsOpenReader.IsOpenReader != 1)
{
richTextBox_idCard_data.Text += "读卡器连接失败,请先打开设备 \r\n";
return;
}
int t_nType = 3; //参数功能暂未实现,1:接触+非接(接触优先) 2:接触+非接(接触优先) 3:接触+非接(接触优先)
int t_nRe = 99;
StringBuilder pOutInfo = new StringBuilder(1024);
t_nRe = Donsee_iReadCardBas(t_nType, pOutInfo);
if (t_nRe == 0)
{
Donsee_Beep();
richTextBox_idCard_data.Text += "读基本信息成功:" + pOutInfo.ToString() + "\r\n";
}
else
{
richTextBox_idCard_data.Text += "读基本信息失败,返回值:" + t_nRe + "\r\n";
}
}