域天控件动态库函数说明

FindPort 函数

FindPort 函数原型：
int FindPort( int start,TCHAR *OutPath);
功能：查找系统中是否存在第N个加密锁，如果存在，则返回该加密锁所在的设备路径
参数１－－start(in)； 要查找的第N个加密锁，例：当start=0时，指的是要查找第一个加密锁所在的设备路径，当start=1时，指的是要查找系统中的第二个加密锁所在的设备路径。

参数2――OutPath(out)；如果系统中存在第N个加密锁，则该参数中包含有该加密锁所在的设备路径

返回结果－－若函数返回0，则表示函数执行成功，系统中存在着第N个加密锁，若返回其它值，则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

GetIDVersion函数

GetIDVersion函数原型：

int GetIDVersion(DWORD *OutID,int *version,TCHAR *KeyPath);
功能：返回锁的短ID及版本号
参数１－－OutID；如果函数操作成功，将会返回锁的短ID到变量OutID中，为一个无符
                 号长整形

参数2――version；如果函数操作成功，将会返回锁的版本号到变量version中，为一个短
整形

参数3――InPath (in)；加密锁所在的设备路径
返回结果－－若函数返回0，则表示函数执行成功，若返回其它值，       则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

GetRunTimr函数

函数原型：

int GetRunTimer(TCHAR *Year,TCHAR *Month,TCHAR *Day,TCHAR *Hour,TCHAR *Minuts,TCHAR *Second,TCHAR *KeyPath);

功能：返回锁的已运行时间，注意：这个指的是通电的时间，加密锁通电计时，不通电不计时。

参数１－－Year；如果函数操作成功，这个字符串变量将会包含有锁运行时间年的部分

参数2――Month；如果函数操作成功，这个字符串变量将会包含有锁运行时间月的部分

参数3――Day；如果函数操作成功，这个字符串变量将会包含有锁运行时间日的部分

参数4――Hour；如果函数操作成功，这个字符串变量将会包含有锁运行时间小时的部分

参数5――Minuts；如果函数操作成功，这个字符串变量将会包含有锁运行时间分钟的部分

参数6――Second；如果函数操作成功，这个字符串变量将会包含有锁运行时间秒的部分

参数7――InPath (in)；加密锁所在的设备路径
返回结果－－若函数返回0，则表示函数执行成功，若返回其它值，       则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

YtReadLong函数

函数原型：

int YtReadLong(long *OutData,short address,TCHAR *HKey,TCHAR *LKey,TCHAR *KeyPath);

功能：从加密锁内部指定地址的储存器中读出长整型数据到变量中，

参数1――OutData长整型变量。

参数2――address；用户指定的加密锁内部地址空间。加密锁内部地址空间由0开始，结束于30719，

参数3――HKey；读密码的高八位密码。16进制字符串（0－F）

参数4――Lkey；读密码的低八位密码。16进制字符串（0－F）

参数5――InPath (in)；加密锁所在的设备路径
返回结果－－若函数返回0，则表示函数执行成功，若返回其它值，       则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

EdccBin函数

EdccBin函数原型：

BOOL EdccBin(TCHAR *Key,BYTE *InByte,long in_len,char *OutErrCode,TCHAR *KeyPath)

功能：根据授权号对二进制的加密数组进行注册，生成注册后的与当前加密锁相对应的另一加密数组。

参数1—与加密锁对应的授权号

参数2—InByte：要注册的二进制的加密数组，如果注册成功，该数组包含有已注册后的加密数组

参数3—in_len：要进行注册的数组长度

参数4--OutErrCode：若函数运行失败，OutErrCode将包含有错误码

参数5—KeyPath；加密锁所在的设备路径

返回结果－－若函数返回真，则表示函数执行成功，若返回假，  则表示函数失败，OutErrCode将包含有错误码，错误原因可以参见错误代码含义

注册文件过程如下：使用(授权号)对(由自定义开发密钥加密后的通用二进制数组)进行注册，如果注册成功，会生成(与当前锁相对应的另一密文二进制数组)，该密文只能被当前锁解密并运行，对于同一通用密文二进制数组，不同的锁或不同的授权号，会生成不同的注册数组。

CalPub函数

函数原型：

int CalPub(BYTE *InByte,long in_len,long *D0,long *D1,LONG *D2,LONG *D3,LONG *D4,LONG *D5,LONG *D6,LONG *D7,       double *F0,double *F1,double *F2,double *F3,double *F4,double *F5,double *F6,double *F7,       TCHAR *S0,TCHAR *S1,TCHAR *S2,TCHAR *S3,TCHAR *S4,TCHAR *S5,TCHAR *S6,TCHAR *S7,TCHAR *KeyPath,long over_count);

功能：在加密锁中运行自定义的加密表达式（即注册后的的密文文件，以数组的形式传递给加密锁，加密锁接受输入的参数，然后将运算后的结果返回给程序。）(使用公共密钥的方式)，注意，这里的CalPub函数与以上的CalEx 函数是有区别的，前者是使用公共密钥的方式，后者是使用私有密钥的方式。

参数1—InByte;含有加密表达式的字节数组（即注册后的的密文文件的二进制字节数组）。

参数2－len,要输入的数组的长度。

参数3至10――长整形变量，要传送给加密锁进行运算的长整形参数。函数操作成功后，该参数保存有运行后相应的长整形变量结果。

参数11至18――浮点变量，要传送给加密锁进行运算的浮点参数。函数操作成功后，该参数保存有运行后相应的浮点变量结果。

参数19至26――字符串变量，要传送给加密锁进行运算的字符串参数。函数操作成功后，该参数保存有运行后相应的字符串变量结果。

参数27――KeyPath (in)；加密锁所在的设备路径

参数28――over_count（in）在加密锁中的最大运行次数,为了防上死循环，在锁中设置了最大的运行次数，用于防止程序死循环。
返回结果－－若函数返回0，则表示函数执行成功，若返回其它值，       则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

CalEx函数

函数原型：

int CalEx(BYTE*InByte,long in_len,long*D0,long*D1,LONG*D2,LONG*D3,LONG*D4,LONG *D5,LONG *D6,LONG *D7,double *F0,double *F1,double *F2,double *F3,double *F4,double*F5,double*F6,double*F7,TCHAR*S0,TCHAR*S1,TCHAR*S2,TCHAR*S3,TCHAR*S4,TCHAR*S5,TCHAR*S6,TCHAR *S7,TCHAR *KeyPath,long over_count);

功能：在加密锁中运行自定义的加密表达式（加密表达式被自定义的密钥加密后，以数组的形式传递给加密锁，加密锁接受输入的参数，然后将运算后的结果返回给程序。）

参数1—InByte;含有加密表达式的字节数组（由自定义的密钥加密对加密表达式加密后生产）。

参数2－len,要输入的数组的长度。

参数3至10――长整形变量，要传送给加密锁进行运算的长整形参数。函数操作成功后，该参数保存有运行后相应的长整形变量结果。

参数11至18――浮点变量，要传送给加密锁进行运算的浮点参数。函数操作成功后，该参数保存有运行后相应的浮点变量结果。

参数19至26――字符串变量，要传送给加密锁进行运算的字符串参数。函数操作成功后，该参数保存有运行后相应的字符串变量结果。

参数27――KeyPath (in)；加密锁所在的设备路径

参数28――over_count（in）在加密锁中的最大运行次数,为了防上死循环，在锁中设置了最大的运行次数，用于防止程序死循环。
返回结果－－若函数返回0，则表示函数执行成功，若返回其它值，       则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

ReadKeyFormEpm函数

函数原型：

功能，从加密锁的读取已写入的授权号，一般用于锁与软件一起给用户，免去了让用户输入授权号的麻烦。

int ReadKeyFormEpm(TCHAR *OutAuthCode,int Addr,TCHAR *HKey,TCHAR *LKey,TCHAR *KeyPath);

参数1- OutAuthCode；如果函数执行成功。将会从加密锁的指定位置读取相应的授权号到该变量中。

参数2：Addr；授权号储存在储存器的起始地址。

参数3：HKey；读储存器的读密码的高8位。

参数4：Lkey：读储存器的读密码的低8位。

参数5――KeyPath (in)；加密锁所在的设备路径

返回结果－－若函数返回0，则表示函数执行成功，若返回其它值，       则表示函数失败，错误原因可以参见错误代码含义。(返回结果为int数据类型，以下不再累述)

 

 

 

 

 

现在发现域天的加密狗比较容易搞定，只有有狗，基本上都可以模拟。