/* ARM 加密锁 API 接口库 */ #ifndef __DONGLE_HEADER_H #define __DONGLE_HEADER_H #include "winscard.h" #pragma comment (lib, "winscard.lib") #ifdef __cplusplus extern "C" { #endif #ifndef IN #define IN #endif #ifndef OUT #define OUT #endif /************************************************************************/ /* 定义 */ /************************************************************************/ //加密锁句柄定义 typedef void * DONGLE_HANDLE; //默认的PIN码重试次数为无限制 //根据种子码初始化锁时会同时初始化PID和ADMINPIN (PID不可更改, ADMINPIN可更改) #define CONST_PID 0xFFFFFFFF //出厂时默认的PID #define CONST_USERPIN "12345678" //出厂时默认的USERPIN #define CONST_ADMINPIN "FFFFFFFFFFFFFFFF" //出厂时默认的ADMINPIN //通讯协议类型定义 #define PROTOCOL_HID 0 //hid协议 #define PROTOCOL_CCID 1 //ccid协议 //文件类型定义 #define FILE_DATA 1 //普通数据文件 #define FILE_PRIKEY_RSA 2 //RSA私钥文件 #define FILE_PRIKEY_ECCSM2 3 //ECC或者SM2私钥文件(SM2私钥文件和ECC私钥文件结构相同，属相同文件类型) #define FILE_KEY 4 //SM4和3DES密钥文件 #define FILE_EXE 5 //可执行文件 //LED灯状态定义 #define LED_OFF 0 //灯灭 #define LED_ON 1 //灯亮 #define LED_BLINK 2 //灯闪 //PIN码类型 #define FLAG_USERPIN 0 //用户PIN #define FLAG_ADMINPIN 1 //开发商PIN //加解密标志 #define FLAG_ENCODE 0 //加密 #define FLAG_DECODE 1 //解密 //HASH算法类型 #define FLAG_HASH_MD5 0 //MD5 运算结果16字节 #define FLAG_HASH_SHA1 1 //SHA1 运算结果20字节 #define FLAG_HASH_SM3 2 //SM3 运算结果32字节 //远程升级的功能号 #define UPDATE_FUNC_CreateFile 1 //创建文件 #define UPDATE_FUNC_WriteFile 2 //写文件 #define UPDATE_FUNC_DeleteFile 3 //删除文件 #define UPDATE_FUNC_FileLic 4 //设置文件授权 #define UPDATE_FUNC_SeedCount 5 //设置种子码可运算次数 #define UPDATE_FUNC_DownloadExe 6 //升级可执行文件 #define UPDATE_FUNC_UnlockUserPin 7 //解锁用户PIN #define UPDATE_FUNC_Deadline 8 //时钟锁升级使用期限 /************************************************************************/ /* 结构 */ /************************************************************************/ //RSA公钥格式(兼容1024,2048) typedef struct { unsigned int bits; // length in bits of modulus unsigned int modulus; // modulus unsigned char exponent[256]; // public exponent } RSA_PUBLIC_KEY; //RSA私钥格式(兼容1024,2048) typedef struct { unsigned int bits; // length in bits of modulus unsigned int modulus; // modulus unsigned char publicExponent[256]; // public exponent unsigned char exponent[256]; // private exponent } RSA_PRIVATE_KEY; //外部ECCSM2公钥格式 ECC(支持bits为192或256)和SM2的(bits为固定值0x8100)公钥格式 typedef struct{ unsigned int bits; // length in bits of modulus unsigned int XCoordinate[8]; // 曲线上点的X坐标 unsigned int YCoordinate[8]; // 曲线上点的Y坐标 } ECCSM2_PUBLIC_KEY; //外部ECCSM2私钥格式 ECC(支持bits为192或256)和SM2的(bits为固定值0x8100)私钥格式 typedef struct{ unsigned int bits; // length in bits of modulus unsigned int PrivateKey[8]; // 私钥 } ECCSM2_PRIVATE_KEY; //加密锁信息 typedef struct { unsigned short m_Ver; //COS版本,比如:0x0201,表示2.01版 unsigned short m_Type; //产品类型: 0xFF表示标准版, 0x00为标准时钟锁,0x02为标准U盘锁 unsigned char m_BirthDay[8]; //出厂日期 unsigned long m_Agent; //代理商编号,比如:默认的0xFFFFFFFF unsigned long m_PID; //产品ID unsigned long m_UserID; //用户ID unsigned char m_HID[8]; //8字节的硬件ID unsigned long m_IsMother; //母锁标志: 0x01表示是母锁, 0x00表示不是母锁 unsigned long m_DevType; //设备类型(PROTOCOL_HID或者PROTOCOL_CCID) } DONGLE_INFO; /** * 锁内文件说明 * 1.RSA私钥文件允许创建的最大数量为8个 * 2.ECCSM2私钥文件允许创建的最大数量为16个 * 3.3DES/SM4密钥文件允许创建的最大数量为32个 * 4.可执行文件允许创建的最大数量为64个,总大小不能超过64K * 5.数据文件创建个数受锁内空间大小和文件系统其他因素的影响，最大个数不超过54个。 * 6.文件ID取值范围为0x0000~0xFFFF之间，其中ID：0x0000、0xFFFF、0x3F00被锁内系统占用，用户不能使用。 */ /*************************文件授权结构***********************************/ //数据文件授权结构 typedef struct { unsigned short m_Read_Priv; //读权限: 0为最小匿名权限，1为最小用户权限，2为最小开发商权限 unsigned short m_Write_Priv; //写权限: 0为最小匿名权限，1为最小用户权限，2为最小开发商权限 } DATA_LIC; //私钥文件授权结构 typedef struct { long m_Count; //可调次数: 0xFFFFFFFF表示不限制, 递减到0表示已不可调用 unsigned char m_Priv; //调用权限: 0为最小匿名权限，1为最小用户权限，2为最小开发商权限 unsigned char m_IsDecOnRAM; //是否是在内存中递减: 1为在内存中递减，0为在FLASH中递减 unsigned char m_IsReset; //用户态调用后是否自动回到匿名态: TRUE为调后回到匿名态 (开发商态不受此限制) unsigned char m_Reserve; //保留,用于4字节对齐 } PRIKEY_LIC; //对称加密算法(SM4/TDES)密钥文件授权结构 typedef struct { unsigned long m_Priv_Enc; //加密时的调用权限: 0为最小匿名权限，1为最小用户权限，2为最小开发商权限 } KEY_LIC; //可执行文件授权结构 typedef struct { unsigned short m_Priv_Exe; //运行的权限: 0为最小匿名权限，1为最小用户权限，2为最小开发商权限 } EXE_LIC; /****************************文件属性结构********************************/ //数据文件属性数据结构 typedef struct { unsigned long m_Size; //数据文件长度，该值最大为4096 DATA_LIC m_Lic; //授权 } DATA_FILE_ATTR; //ECCSM2/RSA私钥文件属性数据结构 typedef struct { unsigned short m_Type; //数据类型:ECCSM2私钥 或 RSA私钥 unsigned short m_Size; //数据长度:RSA该值为1024或2048, ECC该值为192或256, SM2该值为0x8100 PRIKEY_LIC m_Lic; //授权 } PRIKEY_FILE_ATTR; //对称加密算法(SM4/TDES)密钥文件属性数据结构 typedef struct { unsigned long m_Size; //密钥数据长度=16 KEY_LIC m_Lic; //授权 } KEY_FILE_ATTR; //可执行文件属性数据结构 typedef struct { EXE_LIC m_Lic; //授权 unsigned short m_Len; //文件长度 } EXE_FILE_ATTR; /*************************文件列表结构***********************************/ //获取私钥文件列表时返回的数据结构 typedef struct { unsigned short m_FILEID; //文件ID unsigned short m_Reserve; //保留,用于4字节对齐 PRIKEY_FILE_ATTR m_attr; //文件属性 }PRIKEY_FILE_LIST; //获取SM4及TDES密钥文件列表时返回的数据结构 typedef struct { unsigned short m_FILEID; //文件ID unsigned short m_Reserve; //保留,用于4字节对齐 KEY_FILE_ATTR m_attr; //文件属性 }KEY_FILE_LIST; //获取数据文件列表时返回的数据结构 typedef struct { unsigned short m_FILEID; //文件ID unsigned short m_Reserve; //保留,用于4字节对齐 DATA_FILE_ATTR m_attr; //文件属性 }DATA_FILE_LIST; //获取可执行文件列表时返回的数据结构 typedef struct { unsigned short m_FILEID; //文件ID EXE_FILE_ATTR m_attr; unsigned short m_Reserve; //保留,用于4字节对齐 }EXE_FILE_LIST; //下载和列可执行文件时填充的数据结构 typedef struct { unsigned short m_dwSize; //可执行文件大小 unsigned short m_wFileID; //可执行文件ID unsigned char m_Priv; //调用权限: 0为最小匿名权限，1为最小用户权限，2为最小开发商权限 unsigned char *m_pData; //可执行文件数据 }EXE_FILE_INFO; //需要发给空锁的初始化数据 typedef struct { int m_SeedLen; //种子码长度 BYTE m_SeedForPID[256]; //产生产品ID和开发商密码的种子码 (最长250个字节) char m_UserPIN[18]; //用户密码(16个字符的0终止字符串) BYTE m_UserTryCount; //用户密码允许的最大错误重试次数 BYTE m_AdminTryCount; //开发商密码允许的最大错误重试次数 RSA_PRIVATE_KEY m_UpdatePriKey; //远程升级私钥 DWORD m_UserID_Start; //起始用户ID } SON_DATA; //母锁数据 typedef struct { SON_DATA m_Son; //子锁初始化数据 long m_Count; //可产生子锁初始化数据的次数 (-1表示不限制次数, 递减到0时会受限) } MOTHER_DATA; /**************************************************************************/ /* API */ /**************************************************************************/ /** * @brief 枚举加密锁。本函数最多会枚举出32个hid设备和32个ccid设备。 * * @param pDongleInfo [out] 设备信息的数组。当此参数为NULL时, pCount返回找到的设备的数目。 * @param pCount [out] 设备数目。该函数最多可以同时枚举出32个HID设备和32个CCID设备。 * * @return DONGLE_SUCCESS 执行成功。 */ DWORD WINAPI Dongle_Enum(DONGLE_INFO * pDongleInfo, int * pCount); /** * @brief 打开指定的加密锁。 * * @param phDongle [out] 句柄指针。如果打开成功,会被填充。 * @param nIndex [in] 基于0的索引值。指示打开找到的第几把加密锁。 * * @return DONGLE_SUCCESS 打开成功。 */ DWORD WINAPI Dongle_Open(DONGLE_HANDLE * phDongle, int nIndex); /** * @brief 清除PIN码验证状态。将加密锁状态变为匿名。 * * @param hDongle [in] 打开的加密锁句柄。 * * @return DONGLE_SUCCESS 执行成功。 */ DWORD WINAPI Dongle_ResetState(DONGLE_HANDLE hDongle); /** * @brief 关闭打开的加密锁。 * * @param hDongle [in] 打开的加密锁句柄。 * * @return DONGLE_SUCCESS 关闭成功。 */ DWORD WINAPI Dongle_Close(DONGLE_HANDLE hDongle); /** * @brief 产生随机数。匿名权限即可操作。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nLen [in] 要产生的随机数的长度。nLen的取值范围为 1~128。 * @param pRandom [out] 随机数缓冲区。 * * @return DONGLE_SUCCESS 获取随机数成功。 */ DWORD WINAPI Dongle_GenRandom(DONGLE_HANDLE hDongle, int nLen, BYTE * pRandom); /** * @brief LED灯的控制操作。匿名权限即可操作。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFlag [in] 控制类型。例如：nFlag = LED_ON，表示控制LED为亮的状态； * nFlag = LED_OFF，表示控制LED为灭的状态；nFlag = LED_BLINK， * 表示控制LED为闪烁的状态。 * * @return DONGLE_SUCCESS 命令执行成功。 */ DWORD WINAPI Dongle_LEDControl(DONGLE_HANDLE hDongle, int nFlag); /** * @brief 切换通讯协议。调用执行成功后加密锁会自动重启,打开的句柄hDongle会无效,接下来执行关闭操作会返回 * 0xF0000002的错误码，这属正常。如需继续操作，请重新枚举并打开锁。该操作必须要验证开发商PIN码之 * 后方可使用。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFlag [in] 协议类型。例如：nFlag值为PROTOCOL_HID，表示将加密锁切换为HID设备； * nFlag值为PROTOCOL_CCID，表示将加密锁切换为CCID设备 * * @return DONGLE_SUCCESS 执行成功。 */ DWORD WINAPI Dongle_SwitchProtocol(DONGLE_HANDLE hDongle, int nFlag); /** * @brief 一键恢复。即返回出厂状态，加密锁的PID、用户PIN码、开发商PIN码等，全部恢复到出厂状态所有写入的 * 数据都将被清空。另外，调用执行成功后加密锁会自动重启,打开的句柄hDongle会无效,接下来执行关闭操 * 做会返回0xF0000002的错误码，这属正常。如需继续操作，请重新枚举并打开锁。该操作需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * * @return DONGLE_SUCCESS 执行成功。 */ DWORD WINAPI Dongle_RFS(DONGLE_HANDLE hDongle); /** * @brief 创建文件。该函数不支持可执行文件的创建。该操作需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFileType [in] 文件类型。 * nFileType = FILE_DATA，表示创建数据文件；对数据文件有以下说明： * 1.文件大小设为252字节时,最多可创建54个文件,即占用空间13608字节 * 2.文件大小设为1024字节时,最多可创建31个文件，即占用空间31744字节 * 3.文件大小设为4096字节时，最多可创建9个文件,即占用空间36864字节 * nFileType = FILE_PRIKEY_RSA，表示创建RSA私钥文件； * nFileType = FILE_PRIKEY_ECCSM2，表示创建ECCSM2私钥文件； * nFileType = FILE_KEY，表示创建SM4和3DES密钥文件； * 不支持nFileType = FILE_EXE的文件类型。 * @param wFileID [in] 文件ID。 * @param pFileAttr [in] 文件的属性。参数的结构为：DATA_FILE_ATTR、PRIKEY_FILE_ATTR或KEY_FILE_ATTR。 * * @return DONGLE_SUCCESS 创建文件成功。 */ DWORD WINAPI Dongle_CreateFile(DONGLE_HANDLE hDongle, int nFileType, WORD wFileID, void * pFileAttr); /** * @brief 写文件。该函数不支持可执行文件的写入操作，且该操作需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFileType [in] 文件类型。例如， * nFileType = FILE_DATA，表示创建数据文件； * nFileType = FILE_PRIKEY_RSA，表示创建RSA私钥文件； * nFileType = FILE_PRIKEY_ECCSM2，表示创建ECCSM2私钥文件； * nFileType = FILE_KEY，表示创建SM4和3DES密钥文件； * 不支持nFileType = FILE_EXE的文件类型。 * @param wFileID [in] 文件ID。 * @param wOffset [in] 文件偏移。文件写入的起始偏移量。 * @param pInData [in] 准备写入的数据。 * @param nDataLen [in] 参数pInData的大小。 * * @return DONGLE_SUCCESS 写入文件成功。 */ DWORD WINAPI Dongle_WriteFile(DONGLE_HANDLE hDongle, int nFileType, WORD wFileID, WORD wOffset, BYTE * pInData, int nDataLen); /** * @brief 读取加密锁内的数据文件。数据文件的读取权限取决于创建时的设定。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wFileID [in] 文件ID。 * @param wOffset [in] 文件偏移量。 * @param pOutData [in] 数据缓冲区。 * @param nDataLen [out] 参数pOutData的长度。 * * @return DONGLE_SUCCESS 读取数据文件成功 */ DWORD WINAPI Dongle_ReadFile(DONGLE_HANDLE hDongle, WORD wFileID, WORD wOffset, BYTE * pOutData, int nDataLen); /** * @brief 批量下载可执行文件。锁内可执行文件的数量不能超过64个，可执行文件的总大小不能超过64K， * 该操作需要验证管理员权限 * * @param hDongle [in] 打开的加密锁句柄。 * @param pExeFileInfo [in] 可执行文件信息的数组。 * @param nCount [in] 即可执行文件的数量。 * * @return DONGLE_SUCCESS 批量下载可执行文件成功。 */ DWORD WINAPI Dongle_DownloadExeFile(DONGLE_HANDLE hDongle, EXE_FILE_INFO * pExeFileInfo, int nCount); /** * @brief 运行指定的锁内可执行程序。运行可执行文件的权限，取决于批量下载时，每个可执行文件的设置， * 即，EXE_FILE_INFO中的m_Priv参数。输入输出数据的最大长度不能超过1024字节，输入输出数据缓 * 冲区pInOutBuf对应锁内的InOutBuf。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wFileID [in] 可执行文件的文件ID。 * @param pInOutBuf [in,out] 输入输出数据缓冲区。 * @param wInOutBufLen [in] 输入输出数据缓冲区pInOutBuf的大小。 * @param pMainRet [out] 锁内可执行程序main函数的返回值，可以为NULL。 * * @return DONGLE_SUCCESS 运行指定的可执行文件成功。 */ DWORD WINAPI Dongle_RunExeFile(DONGLE_HANDLE hDongle, WORD wFileID, BYTE * pInOutBuf, WORD wInOutBufLen, int * pMainRet); /** * @brief 删除文件。需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFileType [in] 文件类型。 * @param wFileID [in] 文件ID。 * * @return DONGLE_SUCCESS 删除文件成功 */ DWORD WINAPI Dongle_DeleteFile(DONGLE_HANDLE hDongle, int nFileType, WORD wFileID); /** * @brief 列文件。需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFileType [in] 指示文件类型。例如，FILE_DATA等。 * @param pFileList [in] pList：输出文件的列表 (此参数为NULL时, pLen中返回所需的缓冲区长度) * 当nFileType = FILE_DATA时, pFileList指向DATA_FILE_LIST结构； * 当nFileType = FILE_PRIKEY_RSA时, pFileList指向PRIKEY_FILE_LIST结构； * 当nFileType = FILE_PRIKEY_ECCSM2时, pFileList指向PRIKEY_FILE_LIST结构 * 当nFileType = FILE_KEY时, pFileList指向KEY_FILE_LIST结构； * 当nFileType = FILE_EXE时, pFileList指向EXE_FILE_LIST结构。 * @param pDataLen [in,out] 参数pFileList的输入长度，执行成功返回pFileList的字节长度。 * * @return DONGLE_SUCCESS 列文件成功。 */ DWORD WINAPI Dongle_ListFile(DONGLE_HANDLE hDongle, int nFileType, void* pFileList, int * pDataLen); /** * @brief 唯一化锁。输入种子码产生PID和开发商PIN码，需要开发商权限，执行成功后加密锁自动回到匿名态。 * 产生开发商PIN码的目的是为了使密码肯定不是弱密码，产生的开发商PIN可以借助Dongle_ChangePIN * 进行更改。另外，种子码一定要牢记，否则任何人永远无法得知开发商PIN码。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nSeedLen [in] 参数pSeed的缓冲区长度。 * @param pSeed [in] 种子码的缓冲区。 * @param pPIDStr [out] 函数执行成功返回PID。该缓冲区大小至少应该为8字节，返回一个 * 8字节的以0终止的ansi字符串。 * @param pAdminPINstr [out] 函数执行成功返回开发商PIN码。该缓冲区大小至少应该为16字节， * 返回字符串长度为16字节的以0终止的ansi字符串。 * * @return DONGLE_SUCCESS 唯一化锁成功。 */ DWORD WINAPI Dongle_GenUniqueKey(DONGLE_HANDLE hDongle,int nSeedLen, BYTE * pSeed, char * pPIDstr, char * pAdminPINstr); /** * @brief 校验密码 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFlags [in] PIN码类型。参数取值为FLAG_USERPIN或者FLAG_ADMINPIN。 * @param pPIN [in] PIN码，0终止的ansi字符串。 * @param pRemainCount [out] 剩余重试次数。返回0表示已锁死；1~253表示剩余次数；255表示不限制重试次数。 * * @return DONGLE_SUCCESS 校验成功。如果校验失败，函数的返回值中也含有剩余的重试次数， * (错误码 & 0xFFFFFF00) == DONGLE_INCORRECT_PIN，即后两位表示剩余次数。 */ DWORD WINAPI Dongle_VerifyPIN(DONGLE_HANDLE hDongle, int nFlags, char * pPIN, int * pRemainCount); /** * @brief 更改密码 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFlags [in] PIN码类型。参数取值为FLAG_USERPIN或者FLAG_ADMINPIN。 * @param pOldPIN [in] 旧的PIN码缓冲区。必须是一个字符串长度为16字节的0终止的ansi字符串,且可以是中文。 * @param pNewPIN [in] 新的PIN码缓冲区。必须是一个字符串长度为16字节的0终止的ansi字符串。 * @param nTryCount [in] 重试次数。该参数的取值范围为1~255,其中255表示不限制重试次数。 * * @return DONGLE_SUCCESS 修改密码成功。 */ DWORD WINAPI Dongle_ChangePIN(DONGLE_HANDLE hDongle, int nFlags, char * pOldPIN, char * pNewPIN, int nTryCount); /** * @brief 重置用户PIN码。空锁(即PID=FFFFFFFF)不能重置密码。执行成功后用户密码恢复为出厂默认 CONST_USERPIN * * @param hDongle [in] 打开的加密锁句柄。 * @param pAdminPIN [in] 开发商PIN码缓冲区。长度为16字节的0终止的ansi字符串 * * @return DONGLE_SUCCESS 重置用户PIN码成功。 */ DWORD WINAPI Dongle_ResetUserPIN(DONGLE_HANDLE hDongle, char * pAdminPIN); /** * @brief 设置用户ID。需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param dwUserID [in] 用户ID。 * * @return DONGLE_SUCCESS 重置用户PIN码成功。 */ DWORD WINAPI Dongle_SetUserID(DONGLE_HANDLE hDongle, DWORD dwUserID); /** * @brief 获取加密锁到期时间。匿名权限获取。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pdwTime [out] 获取的到期UTC时间值。 * 若*pdwTime = 0XFFFFFFFF，表示不限制到期时间 * 若(*pdwTime & 0XFFFF0000) == 0，值表示还剩余几小时 * 若(*pdwTime & 0XFFFF0000) != 0，值表示到期的UTC的时间，可以通过gmtime等将该值进行转换。 * * @return DONGLE_SUCCESS 获取加密锁到期时间成功。 */ DWORD WINAPI Dongle_GetDeadline(DONGLE_HANDLE hDongle, DWORD * pdwTime); /** * @brief 设置加密锁的到期时间。该操作需要管理员权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param dwTime [in] 时间值。说明： * 1.设置可用小时数，范围在1~65535，例如dwTime = 24。这种情况在校验了用户PIN码后开始计时。 * 2.设置到期的年与日时分秒。可通过函数time或者mktime 取得即时的utc时间值(utc值都大于65535)； * 3.取消到期时间限制，此时dwTime的值只能为0xFFFFFFFF。 * * @return DONGLE_SUCCESS 设置加密锁到期时间成功。 */ DWORD WINAPI Dongle_SetDeadline(DONGLE_HANDLE hDongle, DWORD dwTime); /** * @brief 获取加密锁的UTC时间。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pdwUTCTime [out] UTC时间值指针。 * * @return DONGLE_SUCCESS 设置加密锁到期时间成功。 */ DWORD WINAPI Dongle_GetUTCTime(DONGLE_HANDLE hDongle, DWORD * pdwUTCTime); /** * @brief 读取锁内数据区数据。数据区大小共8k，前4k(0~4095)的读写没有权限限制，后4k(4096~8191)任意权限可读， * 但是只有开发商权限可写。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nOffset [in] 起始偏移。范围在0~8191 * @param pData [out] 读取的数据缓冲区。 * @param nDataLen [in] 参数pData的缓冲区大小。 * * @return DONGLE_SUCCESS 读取数据区数据成功。 */ DWORD WINAPI Dongle_ReadData(DONGLE_HANDLE hDongle, int nOffset, BYTE* pData, int nDataLen); /** * @brief 写入锁内数据区数据。数据区大小共8k，前4k(0~4095)的读写没有权限限制，后4k(4096~8191)任意权限可读， * 但是只有开发商权限可写。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nOffset [in] 起始偏移。范围在0~8191 * @param pData [in] 写入的数据缓冲区。 * @param nDataLen [in] 参数pData的缓冲区大小。 * * @return DONGLE_SUCCESS 写入数据区数据成功。 */ DWORD WINAPI Dongle_WriteData(DONGLE_HANDLE hDongle, int nOffset, BYTE * pData, int nDataLen); /** * @brief 获取共享内存数据。共享内存总大小为32字节。没有权限限制，掉电后数据自动擦除。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pData [out] 输出的数据。输出共享内存的数据，固定为32个字节。 * * @return DONGLE_SUCCESS 获取共享内存数据成功。 */ DWORD WINAPI Dongle_ReadShareMemory(DONGLE_HANDLE hDongle, BYTE * pData); /** * @brief 设置共享内存数据。没有权限限制，掉电后数据自动擦除。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pData [in] 输入数据。 * @param nDataLen [in] 参数pData的缓冲区大小。长度不能超过32。 * * @return DONGLE_SUCCESS 设置共享内存数据成功。 */ DWORD WINAPI Dongle_WriteShareMemory(DONGLE_HANDLE hDongle, BYTE * pData, int nDataLen); /** * @brief 产生RSA公钥和私钥。使用该函数之前需要先创建一个RSA私钥文件。需要开发商权限。成功后注意保存RSA公私钥数据。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] RSA私钥文件ID。 * @param pPubBakup [out] RSA公钥数据。 * @param pPriBakup [out] RSA私钥数据。 * * @return DONGLE_SUCCESS 产生RSA公私钥成功。 */ DWORD WINAPI Dongle_RsaGenPubPriKey(DONGLE_HANDLE hDongle, WORD wPriFileID, RSA_PUBLIC_KEY * pPubBakup, RSA_PRIVATE_KEY * pPriBakup); /** * @brief RSA私钥运算。函数的使用权限取决于锁内RSA私钥文件的权限，在RSA私钥文件创建时设定。说明： * 1.对于加密运算,输入数据长度必须小于私钥ID为wPriFileID的密钥长度除以8再减去11,以便在函数内部进行padding * 2.对于解密运算,输入数据长度必须与wPriFileID中指示的密钥长度相一致(比如1024位密钥时为128，2048时为256) * 3.加密时内部padding方式为:PKCS1_TYPE_1 (即第二个字节为0x01,空数据填充0XFF) * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] RSA私钥文件ID。 * @param nFlag [in] 运算类型。例如，FLAG_ENCODE表示加密运算；FLAG_DECODE表示解密运算。 * @param pInData [in] 输入数据。 * @param nInDataLen [in] 参数pInData的大小 * @param pOutData [out] 输出数据缓冲区。 * @param pOutDataLen [in,out] 参数pOutData的大小和返回的数据大小。 * * @return DONGLE_SUCCESS RSA私钥运算成功。 */ DWORD WINAPI Dongle_RsaPri(DONGLE_HANDLE hDongle, WORD wPriFileID, int nFlag, BYTE * pInData, int nInDataLen, BYTE * pOutData, int * pOutDataLen); /** * @brief RSA公钥运算。匿名权限可调用。说明： * 1.对于加密运算,输入数据长度必须小于pPubKey中指示的密钥长度除以8再减去11,以便在函数内部进行padding * 2.对于解密运算,输入数据长度必须与pPubKey中指示的密钥长度相一致(比如1024位密钥时为128，2048时为256) * 3.加密时内部padding方式为:PKCS1_TYPE_2 (即第二个字节为0x02,空数据填充随机数) * * @param hDongle [in] 打开的加密锁句柄。 * @param nFlag [in] 运算类型。例如，FLAG_ENCODE表示加密运算；FLAG_DECODE表示解密运算。 * @param pPubKey [in] RSA公钥数据。该数据来源于生成RSA公私钥时的公钥数据。 * @param pInData [in] 输入数据。 * @param nInDataLen [in] 参数pInData的大小。 * @param pOutData [out] 输出数据缓冲区。 * @param pOutDataLen [in,out] 参数pOutData的大小和返回的数据大小。 * * @return DONGLE_SUCCESS RSA公钥运算成功。 */ DWORD WINAPI Dongle_RsaPub(DONGLE_HANDLE hDongle, int nFlag, RSA_PUBLIC_KEY * pPubKey, BYTE * pInData, int nInDataLen, BYTE * pOutData, int * pOutDataLen); /** * @brief 产生ECC公钥和私钥。使用该函数之前需要先创建一个ECC私钥文件。需要开发商权限。成功后注意保存ECC公私钥数据。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] ECC私钥文件ID。 * @param pPubBakup [out] ECC公钥数据。 * @param pPriBakup [out] ECC私钥数据。 * * @return DONGLE_SUCCESS 产生ECC公私钥成功。 */ DWORD WINAPI Dongle_EccGenPubPriKey(DONGLE_HANDLE hDongle, WORD wPriFileID, ECCSM2_PUBLIC_KEY * pPubBakup, ECCSM2_PRIVATE_KEY * pPriBakup); /** * @brief ECC私钥签名。函数的使用权限取决于锁内ECC私钥文件的权限，在ECC私钥文件创建时设定。说明： * 1.锁内签名算法为: ECDSA_Sign * 2.输入的Hash值的长度与ECC私钥的密钥长度有关(如果密钥是192位的,则hash值长度不能超过24(192/8 = 24)字节) * (如果密钥是256位的,则hash值长度不能超过32(256/8 = 32)字节) * 3.曲线参数为:EC_NIST_PRIME_192及EC_NIST_PRIME_256 * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] ECC私钥文件ID。 * @param pHashData [in] Hash数据。 * @param nHashDataLen [in] 参数pHashData的大小。 * @param pOutData [out] 签名数据。大小固定为64字节(256位ECC时是正好,192位ECC时的位会补0) * * @return DONGLE_SUCCESS 表示签名成功。 */ DWORD WINAPI Dongle_EccSign(DONGLE_HANDLE hDongle, WORD wPriFileID, BYTE * pHashData, int nHashDataLen, BYTE * pOutData); /** * @brief ECC公钥验签。函数的使用权限取决于锁内ECC私钥文件的权限，在ECC私钥文件创建时设定。说明： * 1.锁内签名算法为: ECDSA_Verify * 2.输入的Hash值的长度与ECC私钥的密钥长度有关(如果密钥是192位的,则hash值长度不能超过24(192/8 = 24)字节) * (如果密钥是256位的,则hash值长度不能超过32(256/8 = 32)字节) * 3.曲线参数为:EC_NIST_PRIME_192及EC_NIST_PRIME_256 * * @param hDongle [in] 打开的加密锁句柄。 * @param pPubKey [in] ECC公钥数据。 * @param pHashData [in] Hash数据。 * @param nHashDataLen [in] 参数pHashData的大小。 * @param pSign [in] 签名数据。大小固定为64字节，为Dongle_EccSign函数返回的pOutData数据。 * * @return DONGLE_SUCCESS 表示验签成功,否则表示验签失败。 */ DWORD WINAPI Dongle_EccVerify(DONGLE_HANDLE hDongle, ECCSM2_PUBLIC_KEY * pPubKey, BYTE * pHashData, int nHashDataLen, BYTE * pSign); /** * @brief 产生SM2公钥和私钥。使用该函数之前需要先创建一个SM2私钥文件。需要开发商权限。成功后注意保存ECC公私钥数据。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] SM2私钥文件ID。 * @param pPubBakup [out] SM2公钥数据。 * @param pPriBakup [out] SM2私钥数据。 * * @return DONGLE_SUCCESS 产生ECC公私钥成功。 */ DWORD WINAPI Dongle_SM2GenPubPriKey(DONGLE_HANDLE hDongle, WORD wPriFileID, ECCSM2_PUBLIC_KEY * pPubBakup, ECCSM2_PRIVATE_KEY * pPriBakup); /** * @brief SM2私钥签名。函数的使用权限取决于锁内SM2私钥文件的权限，在SM2私钥文件创建时设定。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] SM2私钥文件ID。 * @param pHashData [in] Hash数据。 * @param nHashDataLen [in] 参数pHashData的大小。数据长度必须小于32个字节。 * @param pOutData [out] 签名数据。大小固定为64字节。 * * @return DONGLE_SUCCESS 表示签名成功。 */ DWORD WINAPI Dongle_SM2Sign(DONGLE_HANDLE hDongle, WORD wPriFileID, BYTE * pHashData, int nHashDataLen, BYTE * pOutData); /** * @brief SM2公钥验签。函数的使用权限取决于锁内SM2私钥文件的权限，在SM2私钥文件创建时设定。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wPriFileID [in] SM2公钥数据。 * @param pHashData [in] Hash数据。 * @param nHashDataLen [in] 参数pHashData的大小。 * @param pSign [in] 签名数据。大小固定为64字节，为Dongle_EccSign函数返回的pOutData数据。 * * @return DONGLE_SUCCESS 表示验签成功,否则表示验签失败。 */ DWORD WINAPI Dongle_SM2Verify(DONGLE_HANDLE hDongle, ECCSM2_PUBLIC_KEY * pPubKey, BYTE * pHashData, int nHashDataLen, BYTE * pSign); /** * @brief 3DES加解密。解密运算匿名权限即可, 加密运算的权限取决于密钥文件的权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wKeyFileID [in] 密钥文件ID。 * @param nFlag [in] 运算类型。例如，FLAG_ENCODE表示加密运算；FLAG_DECODE表示解密运算。 * @param pInData [in] 输入数据缓冲区。 * @param pOutData [out] 输出数据缓冲区。大小至少要和输入数据缓冲区相同，输入和输出数据缓冲区可以为同一个。 * @param nDataLen [in] 参数pInData的数据大小。数据长度必须是16的整数倍,允许的最大值是1024。 * * @return DONGLE_SUCCESS 3DES加密或解密运算成功。 */ DWORD WINAPI Dongle_TDES(DONGLE_HANDLE hDongle, WORD wKeyFileID, int nFlag, BYTE * pInData, BYTE * pOutData, int nDataLen); /** * @brief SM4加解密。解密运算匿名权限即可, 加密运算的权限取决于密钥文件的权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param wKeyFileID [in] 密钥文件ID。 * @param nFlag [in] 运算类型。例如，FLAG_ENCODE表示加密运算；FLAG_DECODE表示解密运算。 * @param pInData [in] 输入数据缓冲区。 * @param pOutData [out] 输出数据缓冲区。大小至少要和输入数据缓冲区相同，输入和输出数据缓冲区可以为同一个。 * @param nDataLen [in] 参数pInData的数据大小。数据长度必须是16的整数倍,允许的最大值是1024。 * * @return DONGLE_SUCCESS SM4加密或解密运算成功。 */ DWORD WINAPI Dongle_SM4(DONGLE_HANDLE hDongle, WORD wKeyFileID, int nFlag, BYTE * pInData, BYTE * pOutData, int nDataLen); /** * @brief HASH运算。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nFlag [in] Hash运算算法类型。 * nFlag = FLAG_HASH_MD5，表示MD5运算，此时pHash的缓冲区大小为16字节。 * nFlag = FLAG_HASH_SHA1，表示SHA1运算，此时pHash的缓冲区大小为20字节。 * nFlag = FLAG_HASH_SM3，表示国密SM3运算，此时pHash的缓冲区大小为32字节。 * @param pInData [in] 输入数据缓冲区。 * @param nDataLen [in] 参数pInData的数据大小。SHA1、MD5为锁外运算，长度不限制；SM3为锁内运算， * 最大不超过1024字节。 * @param pHash [out] 输出的Hash值。 * * @return DONGLE_SUCCESS HASH运算成功。 */ DWORD WINAPI Dongle_HASH(DONGLE_HANDLE hDongle, int nFlag, BYTE * pInData, int nDataLen, BYTE * pHash); /** * @brief 种子码算法。匿名权限可使用, 开发商可设置可运算次数。 * 1.种子码算法与PID有关，空锁(即PID=FFFFFFFF)不能进行种子码运算。 * 2.如果内部种子码可运算次数不为-1，当其递减到0后此函数将不能使用。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pSeed [in] 输入的种子码数据。 * @param nSeedLen [in] 种子码长度。取值范围为1~250字节。 * @param pOutData [out] 输出数据缓冲区。输出的大小固定为16字节。 * * @return DONGLE_SUCCESS 种子码运算成功。 */ DWORD WINAPI Dongle_Seed(DONGLE_HANDLE hDongle, BYTE * pSeed, int nSeedLen, BYTE * pOutData); /** * @brief 设置种子码算法可运算次数。需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param nCount [in] 可运算次数。如果此值设置为-1，表示不限制运算次数。 * * @return DONGLE_SUCCESS 设置成功。 */ DWORD WINAPI Dongle_LimitSeedCount(DONGLE_HANDLE hDongle, int nCount); /** * @brief 制作一把母锁。子母锁的方式是是一种可选的初始化锁方式，安全又快速，推荐使用。需要开发商权限。 * 1.空锁(即PID=FFFFFFFF)不能写入母锁数据。 * 2.出于安全考虑,MOTHER_DATA中的远程升级私钥不允许和母锁自身的远程升级私钥相同,否则会操作失败。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pInData [in] 输入数据。用于初始化母锁的结构为MOTHER_DATA的数据。 * * @return DONGLE_SUCCESS 制作母锁成功。 */ DWORD WINAPI Dongle_GenMotherKey(DONGLE_HANDLE hDongle, MOTHER_DATA * pInData); /** * @brief 从空锁获取生产请求。此函数只对PID为FFFFFFFF的空锁有效。需要开发商权限。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pRequest [out] 输出数据。返回该数据的有效长度为16字节，因此需要至少16字节的空间。 * * @return DONGLE_SUCCESS 获取生产请求数据成功。 */ DWORD WINAPI Dongle_RequestInit(DONGLE_HANDLE hDongle, BYTE * pRequest); /** * @brief 从母锁获取用于初始化子锁的数据，该函数只对母锁有效。匿名权限可使用。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pRequest [in] 请求数据。通过Dongle_RequestInit获取的请求数据。 * @param pInitData [out] 输出数据。函数执行成功返回用于初始化子锁的数据。 * @param pDataLen [int,out] 参数pInitData的有效长度。表示pInitData的缓冲区长度，函数执行成功 * 返回pInitData的有效长度。 * * @return DONGLE_SUCCESS 从母锁获取生产数据成功。 */ DWORD WINAPI Dongle_GetInitDataFromMother(DONGLE_HANDLE hDongle, BYTE * pRequest, BYTE * pInitData, int * pDataLen); /* * @brief 生产子锁。用子母锁的方式制作子锁，匿名权限即可调用。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pInitData [in] 输入数据。函数Dongle_GetInitDataFromMother返回的用于初始化子锁的数据。 * @param nDataLen [in] 参数pInitData数据缓冲区的有效长度。 * * @return DONGLE_SUCCESS 生产子锁成功。 */ DWORD WINAPI Dongle_InitSon(DONGLE_HANDLE hDongle, BYTE * pInitData, int nDataLen); /** * @brief 向锁内设置远程升级私钥。私钥长度为1024的RSA私钥。需要开发商权限。 * 出于安全考虑，如果锁是母锁的话，远程升级私钥不允许和母锁数据区中的子锁远程升级私钥相同，否则会操作失败。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pPriKey [in] RSA私钥。 * * @return DONGLE_SUCCESS 设置远程升级私钥成功。 */ DWORD WINAPI Dongle_SetUpdatePriKey(DONGLE_HANDLE hDongle, RSA_PRIVATE_KEY * pPriKey); /** * @brief 制作远程升级数据包。匿名权限即可调用。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pHID [in] 硬件序列号。如果不需要绑定该参数可以为NULL。 * @param nFunc [in] 升级包类型。 * nFunc = UPDATE_FUNC_CreateFile，表示创建文件。 * nFunc = UPDATE_FUNC_WriteFile，写文件。只有锁内已有的文件才可升级写文件操作。 * nFunc = UPDATE_FUNC_DeleteFile，删除文件。 * nFunc = UPDATE_FUNC_FileLic，设置文件授权，不支持可执行文件授权升级。 * nFunc = UPDATE_FUNC_SeedCount，设置种子码可运算次数。 * nFunc = UPDATE_FUNC_DownloadExe，升级可执行文件。 * nFunc = UPDATE_FUNC_UnlockUserPin，解锁用户PIN。出于安全考虑解锁用户PIN码必须绑定HID， * 即pHID不能为空，只有这样才能升级成功。升级成功后用户PIN码恢复为"12345678"。 * nFunc = UPDATE_FUNC_Deadline，时钟锁升级使用期限。 * * @param nFileType [in] 文件类型。升级有关文件操作时的文件类型。其他升级类型该参数无效。 * @param wFileID [in] 文件ID。升级有关文件操作时的文件ID。其他升级类型该参数无效。 * 当wFileID=0xFFFF时，表示升级锁内数据区的数据。 * @param nOffset [in] 偏移量。升级有关文件操作时的文件偏移量。其他升级类型该参数无效。 * @param pBuffer [in] 输入数据。 * 当nFunc = UPDATE_FUNC_CreateFile时, pBuffer指向要文件的属性结构，例如KEY_FILE_ATTR。 * 当nFunc = UPDATE_FUNC_WriteFile时, pBuffer指向要写入的数据。 * 当nFunc = UPDATE_FUNC_FileLic时, pBuffer指向文件权限的数据结构，例如：DATA_LIC。 * 当nFunc = UPDATE_FUNC_SeedCount时, pBuffer指向long值，表示种子码可运算次数。 * 当nFunc = UPDATE_FUNC_DownloadExe时, pBuffer指向EXE_FILE_INFO结构，与Dongle_DownloadExeFile函数用法类似。 * 当nFunc = UPDATE_FUNC_Deadline时, pBuffer指向DWORD值，表示到期的时间。 * @param nBufferLen [in] 参数pBuffer的缓冲区大小。 * @param pUPubKey [in] 制作升级包的RSA公钥。与设置到锁内的远程升级私钥相对应。该值无论何种升级类型都必须填写。 * @param pOutData [out] 输出数据。制作的升级包数据。 * @param pOutDataLen [in,out] 参数pOutData输入大小，返回升级包的有效长度。 * * @return DONGLE_SUCCESS 制作升级包成功。 */ DWORD WINAPI Dongle_MakeUpdatePacket(DONGLE_HANDLE hDongle, char * pHID, int nFunc, int nFileType, WORD wFileID, int nOffset, BYTE * pBuffer, int nBufferLen, RSA_PUBLIC_KEY * pUPubKey, BYTE * pOutData, int * pOutDataLen); /** * @brief 制作远程升级数据包。该函数采用母锁方式制作，与Dongle_MakeUpdatePacket相比少了远程升级公钥，其他相同。匿名权限即可调用。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pHID [in] 硬件序列号。如果不需要绑定该参数可以为NULL。 * @param nFunc [in] 升级包类型。 * nFunc = UPDATE_FUNC_CreateFile，表示创建文件。 * nFunc = UPDATE_FUNC_WriteFile，写文件。只有锁内已有的文件才可升级写文件操作。 * nFunc = UPDATE_FUNC_DeleteFile，删除文件。 * nFunc = UPDATE_FUNC_FileLic，设置文件授权，不支持可执行文件授权升级。 * nFunc = UPDATE_FUNC_SeedCount，设置种子码可运算次数。 * nFunc = UPDATE_FUNC_DownloadExe，升级可执行文件。 * nFunc = UPDATE_FUNC_UnlockUserPin，解锁用户PIN。出于安全考虑解锁用户PIN码必须绑定HID， * 即pHID不能为空，只有这样才能升级成功。升级成功后用户PIN码恢复为"12345678"。 * nFunc = UPDATE_FUNC_Deadline，时钟锁升级使用期限。 * * @param nFileType [in] 文件类型。升级有关文件操作时的文件类型。其他升级类型该参数无效。 * @param wFileID [in] 文件ID。升级有关文件操作时的文件ID。其他升级类型该参数无效。 * 当wFileID=0xFFFF时，表示升级锁内数据区的数据。 * @param nOffset [in] 偏移量。升级有关文件操作时的文件偏移量。其他升级类型该参数无效。 * @param pBuffer [in] 输入数据。 * 当nFunc = UPDATE_FUNC_CreateFile时, pBuffer指向要文件的属性结构，例如KEY_FILE_ATTR。 * 当nFunc = UPDATE_FUNC_WriteFile时, pBuffer指向要写入的数据。 * 当nFunc = UPDATE_FUNC_FileLic时, pBuffer指向文件权限的数据结构，例如：DATA_LIC。 * 当nFunc = UPDATE_FUNC_SeedCount时, pBuffer指向long值，表示种子码可运算次数。 * 当nFunc = UPDATE_FUNC_DownloadExe时, pBuffer指向EXE_FILE_INFO结构，与Dongle_DownloadExeFile函数用法类似。 * 当nFunc = UPDATE_FUNC_Deadline时, pBuffer指向DWORD值，表示到期的时间。 * @param nBufferLen [in] 参数pBuffer的缓冲区大小。 * @param pOutData [out] 输出数据。制作的升级包数据。 * @param pOutDataLen [in,out] 参数pOutData输入大小，返回升级包的有效长度。 * * @return DONGLE_SUCCESS 制作升级包成功。 */ DWORD WINAPI Dongle_MakeUpdatePacketFromMother(DONGLE_HANDLE hDongle, char * pHID, int nFunc, int nFileType, WORD wFileID, int nOffset, BYTE * pBuffer, int nBufferLen, BYTE * pOutData, int * pOutDataLen); /** * @brief 远程升级子锁中的数据。匿名权限即可。升级数据pUpdateData对一把锁只能使用一次。 * 1.本函数内部是按1024字节的分块机制发送,如遇返回值不是DONGLE_SUCCESS会立即中断发送并返回。 * 2.如果需要进行流程控制,可由调用方来分块(每块1024字节)发送，并保证数据块的顺序不被打乱，根据返回的错误码来控制流程。 * * @param hDongle [in] 打开的加密锁句柄。 * @param pUpdateData [in] 输入数据。升级数据，由Dongle_MakeUpdatePacket或者Dongle_MakeUpdatePacketFromMother产生 * @param nDataLen [in] 参数pUpdateData的大小。必须为1024的整数倍。 * * @return DONGLE_SUCCESS 升级成功。 */ DWORD WINAPI Dongle_Update(DONGLE_HANDLE hDongle, BYTE * pUpdateData, int nDataLen); //错误码 #define DONGLE_SUCCESS 0x00000000 // 操作成功 #define DONGLE_NOT_FOUND 0xF0000001 // 未找到指定的设备 #define DONGLE_INVALID_HANDLE 0xF0000002 // 无效的句柄 #define DONGLE_INVALID_PARAMETER 0xF0000003 // 参数错误 #define DONGLE_COMM_ERROR 0xF0000004 // 通讯错误 #define DONGLE_INSUFFICIENT_BUFFER 0xF0000005 // 缓冲区空间不足 #define DONGLE_NOT_INITIALIZED 0xF0000006 // 产品尚未初始化 (即没设置PID) #define DONGLE_ALREADY_INITIALIZED 0xF0000007 // 产品已经初始化 (即已设置PID) #define DONGLE_ADMINPIN_NOT_CHECK 0xF0000008 // 开发商密码没有验证 #define DONGLE_USERPIN_NOT_CHECK 0xF0000009 // 用户密码没有验证 #define DONGLE_INCORRECT_PIN 0xF000FF00 // 密码不正确 (后2位指示剩余次数) #define DONGLE_PIN_BLOCKED 0xF000000A // PIN码已锁死 #define DONGLE_ACCESS_DENIED 0xF000000B // 访问被拒绝 #define DONGLE_FILE_EXIST 0xF000000E // 文件已存在 #define DONGLE_FILE_NOT_FOUND 0xF000000F // 未找到指定的文件 #define DONGLE_READ_ERROR 0xF0000010 // 读取数据错误 #define DONGLE_WRITE_ERROR 0xF0000011 // 写入数据错误 #define DONGLE_FILE_CREATE_ERROR 0xF0000012 // 创建文件错误 #define DONGLE_FILE_READ_ERROR 0xF0000013 // 读取文件错误 #define DONGLE_FILE_WRITE_ERROR 0xF0000014 // 写入文件错误 #define DONGLE_FILE_DEL_ERROR 0xF0000015 // 删除文件错误 #define DONGLE_FAILED 0xF0000016 // 操作失败 #define DONGLE_CLOCK_EXPIRE 0xF0000017 // 加密锁时钟到期 #define DONGLE_ERROR_UNKNOWN 0xFFFFFFFF // 未知的错误 #ifdef __cplusplus } #endif #endif