华旭二代证接口动态链接库用户手册

华旭二代证接口动态链接库

用户手册华旭金卡股份有限公司2015年5月修改履历版本日期说明1.0.0.12015-04-30初版1.0.0.22015-05-05增加反盗用功能1.0.0.32015-05-13更新hxgc_std_id_reader.dll产品适用范围本产品是一个WINDOWS系统的动态链接库。适用于WINDOWSXP及以上版本的WINDOWS操作系统。产品组成编号项目说明1hxgc_std_id_reader.dll主库。应用程序调用次库。2sdtapi.dll居民身份证验证安全控制模块接口库3DLL_File.dll照片解码库4license.dat照片解码授权许可文件三产品部署本产品直接复制到PC机上即可适用，要保证产品所有组成项目都在同一个目录下。四接口函数说明4.1■■■■■■如下表，hxgc_std_id_reader.dll导出函数:编号函数名说明1hxgc_OpenReader打开二代证读卡器2hxgc_CloseReader关闭二代证读卡器3hxgc_GetSamIdToStrA读取安全模块编号（ANSI版，简写A）4hxgc_GetSamIdToStrW读取安全模块编号（UNICODE版，简写U）5hxgc_ReadIdChipInfo读取芯片管理号和序列号6hxgc_ReadIdBaseInfo读取身份证基本信息（文字和照片）7hxgc_ReadIdBaseInfoToFileA读取身份证基本信息并写入文件（A）8hxgc_ReadIdBaseInfoToFileW读取身份证基本信息并写入文件（W）

9hxgc_ReadIdBaseAndFp读取身份证基本信息和指纹信息10hxgc_ReadIdBaseAndFpToFileA读取身份证基本信息和指纹信息并写入文件(A)11hxgc_ReadIdBaseAndFpToFileW读取身份证基本信息和指纹信息并写入文件(W)12hxgc_ReadIdNewAddrInfoA读取身份证最新住址信息a)13hxgc_ReadIdNewAddrInfoW读取身份证最新住址信息⑴)14hxgc_DecodeWltDataToBmpA解码照片Wlt数据生成BMP图片文件(A)15hxgc_DecodeWltDataToBmpW解码照片Wlt数据生成BMP图片文件(U)16hxgc_GetIdChInfoItemA解析身份证文字信息(A)17hxgc_GetIdChInfoItemW解析身份证文字信息(U)18hxgc_DecodeWltDataToJpgA解码照片Wlt数据生成JPG图片文件(A)19hxgc_DecodeWltDataToJpgW解码照片Wlt数据生成JPG图片文件(U)20hxgc_MakeFileToBase64EncodeA将文件编码为Base64(A)21hxgc_MakeFileToBase64EncodeW将文件编码为Base64(U)22hxgc_ShowDebugMessage设置是否显示调试信息框••返回值0:成功；hxgc_MakeFileToBase64EncodeA•返回值•返回值0:成功；1：失败。・函数定义int_stdcallhxgc_MakeFileToBase64EncodeA(char*pi_pszFilePath,char*pi_pszFileName,char*po_pszBase64Data,int*pio_piBase64DataLen)；•函数功能读取一个文件，将内容其转化为Base64编码数据。多用于转换身份证照片，BMP和JPG图片文件都可转换。本函数为ANSI版本，文件路径与文件名以ANSI字符串输入。•参数说明编号参数名说明1pi_pszFilePath要转换的文件的路径。不超过260字符长(雨@=)。2pi_pszFileName要转换的文件的文件名。不超过260字符长(char)。3po_pszBase64Data转换得到的8@$064数据串。串内存由函数调用者分配。4pio_piBase64DataLen输入：8@$064数据串内存字符数(char)。至少是文件字节数的1.4倍。输入：8@$064数据串实际字符数。・函数定义int_stdcallhxgc_MakeFileToBase64EncodeW(wchar_t*pi_pwszFilePath,wchar_t*pi_pwszFileName,wchar_t*po_pwszBase64Data,int*pio_piBase64DataLen)；•函数功能读取一个文件，将内容其转化为Base64编码数据。多用于转换身份证照片，BMP和JPG图片文件都可转换。本函数为ANSI版本，文件路径与文件名以UNICODE字符串输入，Base64串也以UNICODE字符串输出。•参数说明编号参数名说明1pi_pwszFilePath要转换的文件的路径。不超过260字符长(wchar_t)。2pi_pwszFileName要转换的文件的文件名。不超过260字符长(wchar_t)。3po_pwszBase64Data转换得到的8@$064数据串。串内存由函数调用者分配。4pio_piBase64DataLen输入：8@$064数据串内存字符数(wchar_t)。至少是文件字节数的1.4倍。输入：8@$064数据串实际字符数。hxgc_ShowDebugMessage函数定义int_stdcallhxgc_ShowDebugMessage(intpi_iShowMode)；函数功能辅助函数。用于设置在发生错误时是否弹出提示况说明错误原因。缺省为不显示。•参数说明编号参数名说明1pi_iShowMode0：不显示。1：显示返回值0:成功；1：失败。五调用说明客户程序调用hxgc_std_id_reader