### 爱迪尔门锁系统接口函数（SDK）详细说明
#### 一、概述
爱迪尔门锁系统接口函数（SDK）是一套专为爱迪尔门锁设计的软件开发工具包，用于实现与门锁系统的交互操作。本SDK支持多个版本的动态链接库（DLL），包括但不限于Lock3200.DLL、Lock3200K.DLL等，适用于爱迪尔门锁系统V5.1及以上但低于V6.5的版本。
#### 二、主要功能介绍
##### 1. Init - 初始化函数
- **函数原型**:
```c
int Init(char* server, int port, int Encoder, int TMEncoder);
```
- **参数说明**:
- `server`: 指向字符数组的指针，用于指定安装了门锁系统数据库的SQL Server名称。
- `port`: 整型变量，指定串口号，例如1表示COM1。
- `Encoder`: 整型变量，表示发行机类型。0代表手动发行机，1代表自动发行机。
- `TMEncoder`: 整型变量，表示TM发行机类型。1代表DS9097E型号，5代表DS9097U型号。
- **返回值**: 参考注释1。
##### 2. EndSession - 结束会话函数
- **函数原型**:
```c
int EndSession(void);
```
- **参数**: 无
- **返回值**: 参考注释1。
##### 3. IssueCard - 发行客人卡函数
- **函数原型**:
```c
int IssueCard(char* room, char* gate, char* stime, char* guestname, char* guestid, int overflag, long* cardno, char* track1, char* track2);
```
- **参数说明**:
- `room`: 字符串，指房间号，最长6个字节。
- `gate`: 字符串，指定公共通道。"00"表示使用默认授权通道；"99"表示授权所有公共通道；其他字符串表示特定通道代码。
- `stime`: 字符串，表示起止时间，格式为“yyyymmddhhnnyyyymmddhhnn”，例如“200012311230200101011230”。
- `guestname`: 字符串，指客人姓名，最长30个字节。
- `guestid`: 字符串，指客人ID，最长30个字节。
- `overflag`: 整型变量，若为1，则覆盖现有卡片内容，并自动注销非新卡；若为0，则不覆盖，且对于非新卡将返回。
- `cardno`: 长整型指针，指向接收卡号的位置，可为空。
- `track1`: 字符串指针，指向磁卡第一轨道数据的位置，可为空。
- `track2`: 字符串指针，指向磁卡第二轨道数据的位置，可为空。
- **返回值**: 参考注释1。
##### 4. ReadCard - 读取卡片信息函数
- **函数原型**:
```c
int ReadCard(char* room, char* gate, char* stime, char* guestname, char* guestid, char* track1, char* track2, long* cardno, int* st);
```
- **参数说明**:
- `room`: 字符串指针，用于接收返回的房间号。
- `gate`: 字符串指针，用于接收返回的授权公共通道。
- `guestname`: 字符串指针，用于接收返回的客人姓名。
- `guestid`: 字符串指针，用于接收返回的客人ID。
- `track1`: 字符串指针，用于接收磁卡第一轨道数据。
- `track2`: 字符串指针，用于接收磁卡第二轨道数据。
- `cardno`: 长整型指针，用于接收返回的卡号。
- `st`: 整型指针，用于接收返回的卡状态（1-正常使用，3-正常注销，4-遗失注销，5-损毁注销，6-自动注销）。
- **返回值**: 参考注释1。
##### 5. EraseCard - 注销卡片并更新数据库函数
- **函数原型**:
```c
int EraseCard(long cardno);
```
- **参数说明**:
- `cardno`: 卡号，可以为0。如果为0，则自动读取卡号并进行注销及数据库更新。
- **返回值**: 参考注释1。
##### 6. CheckOut - 退房更新数据库函数
- **函数原型**:
```c
int CheckOut(char* room, long cardno);
```
- **参数说明**:
- `room`: 字符串，指定房间号。
- `cardno`: 卡号。
- **返回值**: 参考注释1。
#### 三、注意事项
- 在使用SDK之前，请确保已正确安装并设置了门锁系统。
- 对于`Init`函数，正确的数据库服务器名称至关重要，否则初始化失败。
- 使用`IssueCard`函数时，需要注意不同的门锁型号对起止时间有不同的限制。
- `ReadCard`函数可用于读取卡片信息，但需要注意不同类型的卡片可能会返回不同的数据结构。
- `EraseCard`函数主要用于注销卡片，并且能够自动更新数据库中的相应记录。
- `CheckOut`函数用于完成退房操作，只更新数据库而不注销卡片。
#### 四、结语
爱迪尔门锁系统接口函数（SDK）为门锁管理系统提供了强大的技术支持，通过以上介绍的主要功能，开发者可以根据实际需求灵活地调用这些函数来实现门禁控制的各种应用场景。在使用过程中，务必仔细阅读文档，确保正确地设置各项参数，从而充分发挥其效能。
