二代证系统终端API使用手册
打开串口。
int SDT_OpenPort(
int );
参数说明：
iPort
iPort [in] 整数，表示端口号。1-16（十进制）为串口，1001-1016（十进制）为USB口。
返回值：
0x90 1
打开端口成功
打开端口失败/端口号不合法
4.1.5 SDT_ClosePort
关闭串口。
int SDT_ClosePort (
int );
参数说明：
iPort
iPort [in] 整数，表示端口号。
返回值：
0x90 关闭端口成功。 0x01 端口号不合法
4.2 SAM类API
4.2.1 SDT_ResetSAM
对SAM复位。
int SDT_ResetSAM (
int iPort, int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。根据SAM使用的接口不同(分为普通串口SAM和USB
二代证系统终端API使用手册
口SAM)，分别使用不同的端口号（目前串口和USB都只支持16个，即串口0001-0016和USB1001-1016）： 普通串口0001 – 0016(十进制) 例如： SAM 0001：串口1(COM1) 0002：串口2(COM2) USB口SAM 1001 – 1016(十进制) 例如： 1001：USB1 1002：USB2
iIfOpen [in] 整数，0表示不在该函数内部打开和关闭串口，此时确保之前调用了SDT_OpenPort来打开端口，并且在不需要与端口通信时，调用SDT_ClosePort关闭端口；非0表示在API函数内部包含了打开端口和关闭端口函数，之前不需要调用SDT_OpenPort，也不用再调用SDT_ClosePort。
返回值：
0x90 其他
成功
失败（具体含义参见返回码表）
4.2.2 SDT_GetSAMStatus
对SAM进行状态检测。 int SDT_GetSAMStatus (
int iPort, int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
iIfOpen [in] 整数，参见SDT_ResetSAM。
返回值：
0x90 SAM正常
0x60 自检失败，不能接收命令
其他 命令失败（具体含义参见返回码表）
4.2.3 SDT_GetSAMID
读取SAM的编号。 int SDT_GetSAMID (
int iPort, unsigned char * pucSAMID,
二代证系统终端API使用手册
int
iIfOpen
);
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
pucSAMID [out] 无符号字符串指针，指向读到的SAM编号，
返回值：
0x90 成功
其他 失败（具体含义参见返回码表）
4.3.4 SDT_GetSAMIDToStr
读取SAM的编号。
int SDT_GetSAMIDToStr (
int iPort, char * pcSAMID， int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
pcSAMID [out] 字符串指针，指向读到的SAM编号。
iIfOpen [in] 整数，参见SDT_ResetSAM。
返回值：
0x90 成功
其他
失败（具体含义参见返回码表）
4.3 身份证卡类API
4.3.1 SDT_StartFindIDCard
开始找卡。
字节。 16 二代证系统终端API使用手册
int SDT_StartFindIDCard (
int iPort , unsigned char * pucIIN, int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
pucIIN [out] 无符号字符指针，指向读到的IIN。
iIfOpen [in] 整数，参见SDT_ResetSAM。
返回值：
0x9f 找卡成功 0x80 找卡失败
4.3.2 SDT_SelectIDCard
选卡。
int SDT_ SelectIDCard (
int iPort , unsigned char * pucSN, int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
pucSN [out] 无符号字符指针，指向读到的SN。
iIfOpen [in] 整数，参见SDT_ResetSAM。
返回值：
0x90 选卡成功 0x81 选卡失败
4.3.3 SDT_ReadBaseMsg
读取ID卡内基本信息区域信息。 int SDT_ReadBaseMsg (
二代证系统终端API使用手册
int iPort， unsigned char * pucCHMsg， unsigned int * puiCHMsgLen， unsigned char * pucPHMsg， unsigned int * puiPHMsgLen, int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
pucCHMsg [out] 无符号字符指针，指向读到的文字信息。
puiCHMsgLen [out] 无符号整型数指针，指向读到的文字信息长度。
pucPHMsg [out] 无符号字符指针，指向读到的照片信息。
puiPHMsgLen [out] 无符号整型数指针，指向读到的照片信息长度。
iIfOpen [in] 整数，参见SDT_ResetSAM。
返回值：
0x90 读基本信息成功
其他 读基本信息失败（具体含义参见返回码表）
4.3.4 SDT_ReadIINSNDN
读取ID卡内IIN,SN和DN。 int SDT_ReadIINSNDN (
int iPort， unsigned char * pucIINSNDN, int iIfOpen );
参数说明：
iPort [in] 整数，表示端口号。参见SDT_ResetSAM。
pucIINSNDN [out] 无符号字符指针，指向读到的IIN,SN和DN,长度为固定28字节。
iIfOpen [in] 整数，参见SDT_ResetSAM。