IC卡操作

以 IC 卡发钥匙

功能简介：

函数用于用生成宾客 IC 卡。

函数 C 语言原型:

int __stdcall KCheckinByICCard(int portName,
        char *hostURL, char *userName, char *userPasswd, char *deviceID,
        char *expiryDate, char *owner, char *ownerID, int options,
        char *returnKeyID, char *returnCardID);

参数说明

参数名	类型	定义
portName	int	IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1
hostURL	char*	访问后台 URL
userName	char*	访问账号
userPasswd	char*	访问密码
deviceID	char*	门锁的设备 ID，以 10 进制字符串格式表示, 如果需要指定一卡开多设备（如：电梯控制器），则请用半角‘,’将每个设备 ID 分隔，末尾不要加','（如：‘111,222’）
expiryDate	char*	钥匙失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00”
owner	char*	持有人名
ownerID	char*	持有人 ID 号码
options	int	保留,默认填 0
returnKeyID	char*	操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示注意：需先分配至少 32 字节空间传入
returnCardID	char*	操作成功后会返回当前 IC 卡的 UID，以 8 位 16 进制字符串格式表示注意：需先分配至少 32 字节空间传入

返回值

0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义), 如果返回 -4，表示多设备操作过程中，与某个设备通信受干扰被中断，请调用修复钥匙操作进行修复。

以 IC 卡读钥匙

功能简介：

函数用于读取当前 IC 卡的详细钥匙信息。

函数 C 语言原型:

int __stdcall KReadInfoByICCard(int portName,
        char *hostURL, char *userName, char *userPasswd,
        char *returnKeyID, char *returnOwner,
        char *returnOwnerID, char *returnDeviceID,
        char *returnExpiryDate, char *returnCardID);

参数说明

参数名	类型	定义
portName	int	IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1
hostURL	char*	访问后台 URL
userName	char*	访问账号
userPasswd	char*	访问密码
returnKeyID	char*	操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示注意：需先分配至少 32 字节空间传入
returnOwner	char*	持有人名注意：需先分配至少 32 字节空间传入
returnOwnerID	char*	持有人 ID 号码注意：需先分配至少 32 字节空间传入
returnDeviceID	char*	门锁的设备 ID，以 10 进制字符串格式表示, 如果该钥匙被指定为一卡开多设备（如：电梯控制器），则每个设备 ID 号之前将以半角‘,’分隔（如：‘111,222’）注意：需先分配至少 32 字节空间传入
returnExpiryDate	char*	钥匙失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00” 注意：需先分配至少 32 字节空间传入
returnCardID	char*	操作成功后会返回当前 IC 卡的 UID，以 8 位 16 进制字符串格式表示注意：需先分配至少 32 字节空间传入

返回值

0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义)

以 IC 卡续住

功能简介：

函数用于给当前 IC 卡续卡(即延长有效时间）。

函数 C 语言原型:

int __stdcall KUpdateExpiryDateByICCard(int portName,
        char *hostURL, char *userName, char *userPasswd,
        char *newExpiryDate, int options);

参数说明

参数名	类型	定义
portName	int	IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1
hostURL	char*	访问后台 URL
userName	char*	访问账号
userPasswd	char*	访问密码
newExpiryDate	char*	钥匙的新失效时间的 ISO Time 格式，如：“2019-09-18T12:00:00”
options	int	保留,默认填 0

返回值

0 表示操作成功，其它值表示失败，请查阅对应的错误码。(返回值定义)

以 IC 卡退卡

功能简介：

函数用于注销当前的 IC 卡。

函数 C 语言原型:

int __stdcall KCheckoutByICCard(int portName,
        char *hostURL, char *userName, char *userPasswd,
        char *returnKeyID);

参数说明

参数名	类型	定义
portName	int	IC 卡发卡机端口或者身份证读卡器端口，如果对应端口为 COM1，则请填 1
hostURL	char*	访问后台 URL
userName	char*	访问账号
userPasswd	char*	访问密码
returnKeyID	char*	操作成功后会返回新创建的钥匙的钥匙 ID，以 10 进制字符串格式表示注意：需先分配至少 32 字节空间传入

返回值

其于DLL的API定义

身份证操作

内容

以 IC 卡发钥匙
以 IC 卡读钥匙
以 IC 卡续住
以 IC 卡退卡