全功能ActiveX控件参考手册+.pdf

ET99 全功能ActiveX 控件参考手册1.0 概述 这一节概述利用ET99全功能ActiveX控件来编写ET99的程序。你可以在任 何支持COM或OLE技术的开发环境中使用这个ActiveX控件，如下面的平台可以 使用： • Microsoft Visual C++ • Microsoft Visual Basic • Inprise C++ Builder • Inprise Delphi 你可以在SDK包的samples的子目录下看到相关的事例代码。 ET99全功能ActiveX控件覆盖了所有的API提供的接口函数。它提供了如 下的接口： IET99MOD接口覆盖所有的函数接口： CLSID: {1AD79C4B-0D2A-4C67-BE0B-6DD608CE2BCC} IID:{ 1AD79C4B-0D2A-4C67-BE0B-6DD608CE2BCC} ProgID: ET99_MOD.ET99MOD.1 FindToken 函数 FindToken 查看计算机连接有多少个指定 pid 的ET99 。 函数原型： HRESULT FindToken( [in] BYTE* pid, [out] int* count ); 参数： pid [in] 这个参数指定要查找设备的 pid ，为固定长度的 8 个字节长度的字符； count [out] 返回找到的设备的个数。 注解： 这个函数一般用在调用的第一个函数，用于查看计算机上连接了 ET99 的个数，然后再 根据连接的个数来打开第几个设备。 返回值： ET_SUCCESS: 执行成功,Count 为查找到的数目； ET_UNIT_NOT_FOUND:没有可以用的硬件，此时 Count 值为 0 。 OpenToken 函数 OpenToken 用来打开指定的 ET99 设备。 函数原型： HRESULT OpenToken( [in] BYTE* pid, [in] int index ); 参数： pid [in] 这个参数指定要打开设备的 pid ，为固定长度的 8 个字节长度的字符； index [in] 这个参数用来指定要打开的是第几个 ET99 的设备。 注解： 查看计算机上有多少个 ET99 以后，再利用该函数来打开指定的设备，以后的函数调用 都必须基于这个函数调用。 返回值： ET_SUCCESS: 执行成功。 ET_UNIT_NOT_FOUND:打开指定的设备失败。 CloseToken 函数 CloseToken 用来关闭已经打开的 ET99 设备。 函数原型： HRESULT CloseToken(); 要求： OpenToken 。 参数： 无 注解： 用来关闭已经打开的 ET99 设备。 返回值： ET_SUCCESS: 执行成功。 ET_COMMUNICATIONS_ERROR ：没有打开设备。 VerifyPIN 函数VerifyPIN 用来验证 PIN 码，以获得相应的安全状态。 函数原型： HRESULT VerifyPIN( [in] int Flags, [in] unsigned char* pucPIN ); 要求： OpenToken 。 参数： lFlags [in] 验证 Pin 码的类型，取值如下： ET_VERIFY_USERPIN 验证的为普通用户 PIN 码 ET_VERIFY_SOPIN 验证的是超级用户 PIN 码 pucPIN [in] 指向一个包含验证 pin 码的缓冲区，长度固定为 16 个字节长。 注解： 如果验证普通用户 PIN 码或者超级用户 PIN 错误，并且错误值在 0xF0 和 ET_PIN_ERR_MAX （0xFF ）之间,则返回值的后四位为剩