《华旭二代证接口动态链接库用户手册》由会员分享，可在线阅读，更多相关《华旭二代证接口动态链接库用户手册（31页珍藏版）》请在金锄头文库上搜索。
1、用户手册V 1.0.0.3华旭金卡股份有限公司2015年5月修改履历版本日期说明l.O.O.l2015-04-30初版1.0.0.22015-05-05增加反盗用功能1.0.0.32015-05-13更新 hxgc std id reader.dll产品适用范本产品是一个 WINDOWS 系统的动态链接库。适用于 WINDOWS XP 及以上版本的 WINDOWS操作系统。产品组成编号项目说明1hxgc std id reader.dll主库。应用程序调用次库。2sdt api.dll居民身份证验证安全控制模块接口库3DLL File.dll照片解码库4license.da t照片解码授权许可
2、文件三产品部署本产品直接复制到PC机上即可适用，要保证产品所有组成项目都在同一个目录 下。四接口函数说明4.1 接口函数列表如下表，hxgc std id reader.dll 导出函数:编号函数名说明1hxgc OpenReader打开二代证读卡器2hxgc CloseReader关闭二代证读卡器3hxgc GetSamldToStrA读取安全模块编号（ANSI版，简写A）4hxgc GetSamldToStrW读取安全模块编号（UNICODE版，简写U）5hxgc ReadIdChipInfo读取芯片管理号和序列号6hxgc ReadIdBaseInfo读取身份证基本信息（文字和照片）7h
3、xgc ReadIdBaseInfoToFileA读取身份证基本信息并写入文件（A）8hxgc ReadIdBaseInfoToFileW读取身份证基本信息并写入文件（W）9hxgc ReadIdBaseAndFp读取身份证基本信息和指纹信息10hxgc_ReadIdBaseAndFpToFileA读取身份证基本信息和指纹信息并写入文件 (A)11hxgc_ReadIdBaseAndFpToFileW读取身份证基本信息和指纹信息并写入文件 (W)12hxgc ReadIdNewAddrInfoA读取身份证最新住址信息(A)13hxgc ReadIdNewAddrInfoW读取身份证最新住址信息
4、(U)14hxgc DecodeWltDataToBmpA解码照片Wlt数据生成BMP图片文件(A)15hxgc DecodeWltDataToBmpW解码照片Wlt数据生成BMP图片文件(U)16hxgc GetldChlnfolt emA解析身份证文字信息(A)17hxgc GetldChlnfoItemW解析身份证文字信息(U)18hxgc DecodeWltDataToJpgA解码照片Wlt数据生成JPG图片文件(A)19hxgc DecodeWltDataToJpgW解码照片Wlt数据生成JPG图片文件(U)20hxgc MakeFileToBase64EncodeA将文件编码为Ba
5、se64(A)21hxgc MakeFileToBase64EncodeW将文件编码为Base64(U)22hxgc ShowDebugMessage设置是否显示调试信息框4.2 接口函数说明接口函的数参的数命名以一个前缀说明这个参数的输入输出类型 pi_ 表示参数是输入参数。po_ 表示参数是输出参数。pio_ 表示参数是输入输出参数。4.2.1 hxgc_OpenReader 函数功能打开指定端口上的读卡器。使用完毕后要调用 hxgc_CloseReader 关闭函数定义int _stdcall hxgc_OpenReader(int pi_iPort)； 参数说明编号参数名说明1pi_i
6、Port端口号。116为串口号。10011016为USB 口号，缺省的一 个USB设备端口号为1001.4.2.2 hxgc_CloseReader关闭指定端口上的读卡器。函数定义int _stdcall hxgc_CloseReader( int pi_iPort)；参数说明编号参数名说明1pi_iPort端口号。116为串口号。10011016为USB 口号，缺省的一 个USB设备端口号为1001。返回值0:成功；1：失败。4.2.3 hxgc_GetSamIdToStrA函数定义int _stdcall hxgc_GetSamldToStrA(int pi_iPort,char* po_
7、szSamId, unsigned int* pio_puiSamIdLen)；函数功能获取SAM模块的编号，编号以字符串输出。本函数为ANSI版本，SAM ID以ANSI字符串输出。本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。参数说明编号参数名说明1pi_iPort端口号。广16为串口号。10011016为USB 口号，缺省 的一个USB设备端口号为1001。2po_szSamId获取到的SAM ID。串内存由函数调用者分配。至少分配 MAX ID SAM ID STRING LEN+1 个 char 字符(40+1 字符)。3pio_puiSamIdLen
8、输入：SAM ID串内存的长度，以字符数(char)为单位。 输出：SAM ID实际长度。注意：ANSI字符串中，汉字占两字符。返回值0:成功；1：失败。4.2.4 hxgc_GetSamIdToStrW函数定义int _stdcall hxgc_GetSamldToStrW(int pi_iPort,wchar_t* po_wszSamId, unsigned int* pio_puiSamIdLen)；函数功能获取SAM模块的编号，编号以字符串输出。 本函数为UNIODE版本，SAM ID以UNIODE字符串输出。本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回
9、。参数说明编号参数名说明1pi_iPort端口号。广16为串口号。10011016为USB 口号，缺省 的一个USB设备端口号为1001。2po_wszSamId获取到的SAM ID。串内存由函数调用者分配。至少分配 MAX_ID_SAM_ID_STRING_LEN+1 个 wchar_t 字符(40+1 字 符)。3pio_puiSamIdLen输入：分配SAM ID的串内存的长度，以字符(wchar_t) 为单位。输出：SAM ID实际长度。注意：UNICODE字符串中，汉字占一字符。返回值0:成功；1：失败。4.2.5 hxgc_ReadIdChipInfo函数定义int _stdcal
10、l hxgc_ReadIdChipInfo(int pi_iPort,unsigned char* po_pbysChipManageNumber, unsigned int* pio_puiChipManageNumberSize, unsigned char* po_pbysChipSerialNumber, unsigned int* pio_puiChipSerialNumberSize)；函数功能读取身份证芯片信息。本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。参数说明编号参数名说明1pi_iPort端口号。广16为串口号。10011016为USB 口
11、号，缺省 的一个USB设备端口号口为1001。2po pbysChipManageNumber读取的芯片管理号。内存由函数调用者分配。3pio_puiChipManageNumberSize输入：分配的芯片管理号的内存块的大小，以字节为单 位。最少分配MAX_ID_CHIP_MANAGE_NUMBER_SIZE 字节（4字节）。输出：芯片管理号实际占用的字节数。4po pbysChipSerialNumber读取的芯片序列号。内存由函数调用者分配。5pio_puiChipSerialNumberSize输入：分配的芯片序列号的内存块的大小，以字节为单 位。最少分配 MAX_ID_CHIP_SE
12、RIAL_NUMBER_SZIE 字节（8字节）。输出：芯片序列号实际占用的字节数。4.2.6 hxgc_ReadIdBaseInfo函数定义int _stdcall hxgc_ReadIdBaseInfo(int pi_iPort,unsigned char* po_pbysCHInfo,unsigned int* pio_puiCHInfoSize,unsigned char* po_pbysPHInfo,unsigned int* pio_puiPHInfoSize)；函数功能 读取身份证基本信息，基本信息是：身份证文字信息 +照片信息。 本函数要在hxgc_OpenReader函数执行
13、成功后才能调用，否则失败返回。参数说明编号参数名说明1pi_iPort端口号。广16为串口号。10011016为USB 口号，缺省 的一个USB设备端口号口为1001。2po_pbyCHInfo读取的文字信息。内存由函数调用者分配。读取出来的数据是身份证内的原始数据，内容实质是 UNICODE 字符。最少分配MAX ID CHMSG SIZE字节（256字节）。3pio_puiCHInfoSize输入：分配的文字信息的内存块的大小，以字节为单位。 输出：文字信息实际占用的字节数。4po_pbysPHInfo读取的照片。内存由函数调用者分配。 最少分配MAX_ID_PHMSG_SIZE字节（10
14、24字节）。 读出来的数据是Wit秘闻数据。需要解码使用。5po_puiChipSerialNumberSize输入：分配的照片的内存块的大小，以字节为单位。 输出：照片实际占用的字节数。4.2.7 hxgc_ReadIdBaseInfoToFileA函数定义int _stdcall hxgc_ReadIdBaseInfoToFileA(int pi_iPort,char* pi_pszCHInfoFileName,unsigned int* po_puiCHInfoFileSize,char* pi_pszPHInfoFileName, unsigned int* po_puiPHInfoFileSize)；函数功能 读取身份证基本信息写入磁盘文件，基本信息是：身份证文字信息 +照片信息。 本函数为ANSI版本，文件名以ANSI字符串输入。函数执行会新建文件或覆盖同 名文件。本函数要在hxgc_OpenReader函数执行成功后才能调用，否则失败返回。参数
