全功能ActiveX控件参考手册

### 全功能ActiveX控件参考手册知识点解析 #### 一、概述 本文档主要介绍了ET99全功能ActiveX控件的相关知识及其在不同开发环境中的应用方法。该控件支持多种主流开发平台，包括但不限于Microsoft Visual C++、Microsoft Visual Basic、Inprise C++ Builder以及Inprise Delphi等。 #### 二、支持的开发环境 ET99全功能ActiveX控件可以在以下开发环境中使用： - **Microsoft Visual C++**：适用于Windows平台的应用程序开发。 - **Microsoft Visual Basic**：适合快速应用程序开发，尤其是图形用户界面的设计。 - **Inprise C++ Builder**：提供了高效的C++编译器和集成开发环境(IDE)。 - **Inprise Delphi**：基于Pascal语言的快速应用程序开发工具，特别适合于Windows和跨平台开发。 #### 三、SDK包与示例代码 SDK包中包含了控件的源代码以及其他资源文件，开发者可以在`samples`子目录下找到具体的示例代码，这些示例可以帮助开发者更快地理解和使用该控件。 #### 四、ET99全功能ActiveX控件接口介绍 ET99全功能ActiveX控件覆盖了所有API提供的接口函数，主要包括以下几个重要的接口： ##### 1. `IET99MOD` 接口 - **CLSID**: `{1AD79C4B-0D2A-4C67-BE0B-6DD608CE2BCC}` - **IID**: `{1AD79C4B-0D2A-4C67-BE0B-6DD608CE2BCC}` - **ProgID**: `ET99_MOD.ET99MOD.1` - **`FindToken` 函数** - **功能**: 检测当前计算机连接的指定PID的ET99设备数量。 - **参数**: - `pid`: 输入参数，指定设备的PID，固定长度为8个字节。 - `count`: 输出参数，返回找到的设备数量。 - **返回值**: - `ET_SUCCESS`: 成功执行，`count`返回设备数量。 - `ET_UNIT_NOT_FOUND`: 没有找到可用硬件，`count`值为0。 - **`OpenToken` 函数** - **功能**: 打开指定的ET99设备。 - **参数**: - `pid`: 输入参数，指定要打开设备的PID，固定长度为8个字节。 - `index`: 输入参数，指定要打开的是第几个ET99设备。 - **返回值**: - `ET_SUCCESS`: 成功执行。 - `ET_UNIT_NOT_FOUND`: 打开指定设备失败。 - **`CloseToken` 函数** - **功能**: 关闭已打开的ET99设备。 - **参数**: 无 - **返回值**: - `ET_SUCCESS`: 成功执行。 - `ET_COMMUNICATIONS_ERROR`: 设备未打开。 - **`VerifyPIN` 函数** - **功能**: 验证PIN码，获取相应安全状态。 - **参数**: - `Flags`: 输入参数，验证PIN码的类型，例如`ET_VERIFY_USERPIN`或`ET_VERIFY_SOPIN`。 - `pucPIN`: 输入参数，指向包含PIN码的缓冲区，固定长度为16个字节。 - **返回值**: - `ET_SUCCESS`: 成功验证。 - `ET_INVALID_PARAMETER`: 参数无效。 - `ET_COMMUNICATIONS_ERROR`: 设备未打开。 - 特殊情况：如果PIN码验证错误，返回值的后四位代表剩余尝试次数；若返回0xFF，则表示验证错误且重试次数无限。 - **`ChangeUserPIN` 函数** - **功能**: 更改普通用户的PIN码。 - **参数**: - `pucOldPIN`: 输入参数，指向包含旧PIN码的缓冲区，长度为16个字节。 - `pucNewPIN`: 输入参数，指向包含新PIN码的缓冲区，长度为16个字节。 - **返回值**: - `ET_SUCCESS`: 成功更改PIN码。 - `ET_HARD_ERROR`: 硬件错误。 - 特殊情况：如果PIN码验证错误，返回值的后四位代表剩余尝试次数；若返回0xFF，则表示验证错误且重试次数无限。 通过上述接口的详细介绍，我们可以看出ET99全功能ActiveX控件提供了丰富的功能支持，包括设备检测、打开与关闭、PIN码验证及修改等功能，为开发者提供了极大的便利性和灵活性。此外，文档还提供了必要的参数说明和错误处理建议，帮助开发者更高效地进行开发工作。