smsdll.h

手机的短信程序

#ifndef _smsdll_h_
#define _smsdll_h_

#include <windows.h>
// 用户信息编码方式
#define GSM_7BIT        0
#define GSM_8BIT        4
#define GSM_UCS2        8

// 串口设备句柄
HANDLE hComm;
        
// 短消息参数结构，编码/解码共用
// 其中，字符串以0结尾
typedef struct {
    char SCA[16];       // 短消息服务中心号码(SMSC地址)
    char TPA[16];       // 目标号码或回复号码(TP-DA或TP-RA)
    char TP_PID;        // 用户信息协议标识(TP-PID)
    char TP_DCS;        // 用户信息编码方式(TP-DCS)
    char TP_SCTS[16];   // 服务时间戳字符串(TP_SCTS), 接收时用到
    char TP_UD[161];    // 原始用户信息(编码前或解码后的TP-UD)
    char index;         // 短消息序号，在读取时用到
} SM_PARAM;

// 正常顺序的字符串转换为两两颠倒的字符串，若长度为奇数，补'F'凑成偶数
// 如："8613851872468" --> "683158812764F8"
// pSrc: 源字符串指针
// pDst: 目标字符串指针
// nSrcLength: 源字符串长度
// 返回: 目标字符串长度
extern "C" _declspec(dllexport)  int _cdecl gsmInvertNumbers(const char* pSrc, char* pDst, int nSrcLength);
// 两两颠倒的字符串转换为正常顺序的字符串
// 如："683158812764F8" --> "8613851872468"
// pSrc: 源字符串指针
// pDst: 目标字符串指针
// nSrcLength: 源字符串长度
// 返回: 目标字符串长度
extern "C" _declspec(dllexport)  int _cdecl gsmSerializeNumbers(const char* pSrc, char* pDst, int nSrcLength);
// PDU编码，用于编制、发送短消息
// pSrc: 源PDU参数指针
// pDst: 目标PDU串指针
// 返回: 目标PDU串长度
extern "C" _declspec(dllexport)  int _cdecl gsmEncodePdu(const SM_PARAM* pSrc, char* pDst);
// PDU解码，用于接收、阅读短消息
// pSrc: 源PDU串指针
// pDst: 目标PDU参数指针
// 返回: 用户信息串长度
extern "C" _declspec(dllexport)  int _cdecl gsmDecodePdu(const char* pSrc, SM_PARAM* pDst);
// 7-bit编码
// pSrc: 源字符串指针
// pDst: 目标编码串指针
// nSrcLength: 源字符串长度
// 返回: 目标编码串长度
extern "C" _declspec(dllexport)  int _cdecl gsmEncode7bit(const char* pSrc, unsigned char* pDst, int nSrcLength);
// 7-bit解码
// pSrc: 源编码串指针
// pDst: 目标字符串指针
// nSrcLength: 源编码串长度
// 返回: 目标字符串长度
extern "C" _declspec(dllexport)  int _cdecl gsmDecode7bit(const unsigned char* pSrc, char* pDst, int nSrcLength);
// 8bit编码
// pSrc: 源字符串指针
// pDst: 目标编码串指针
// nSrcLength: 源字符串长度
// 返回: 目标编码串长度
extern "C" _declspec(dllexport)  int _cdecl gsmEncode8bit(const char* pSrc, unsigned char* pDst, int nSrcLength);
// 8bit解码
// pSrc: 源编码串指针
// pDst: 目标字符串指针
// nSrcLength: 源编码串长度
// 返回: 目标字符串长度
extern "C" _declspec(dllexport)  int _cdecl gsmDecode8bit(const unsigned char* pSrc, char* pDst, int nSrcLength);
// UCS2编码
// pSrc: 源字符串指针
// pDst: 目标编码串指针
// nSrcLength: 源字符串长度
// 返回: 目标编码串长度
extern "C" _declspec(dllexport)  int _cdecl gsmEncodeUcs2(const char* pSrc, unsigned char* pDst, int nSrcLength);
// UCS2解码
// pSrc: 源编码串指针
// pDst: 目标字符串指针
// nSrcLength: 源编码串长度
// 返回: 目标字符串长度
extern "C" _declspec(dllexport)  int _cdecl gsmDecodeUcs2(const unsigned char* pSrc, char* pDst, int nSrcLength);
// 可打印字符串转换为字节数据
// 如："C8329BFD0E01" --> {0xC8, 0x32, 0x9B, 0xFD, 0x0E, 0x01}
// pSrc: 源字符串指针
// pDst: 目标数据指针
// nSrcLength: 源字符串长度
// 返回: 目标数据长度
extern "C" _declspec(dllexport)  int _cdecl gsmString2Bytes(const char* pSrc, unsigned char* pDst, int nSrcLength);
// 字节数据转换为可打印字符串
// 如：{0xC8, 0x32, 0x9B, 0xFD, 0x0E, 0x01} --> "C8329BFD0E01" 
// pSrc: 源数据指针
// pDst: 目标字符串指针
// nSrcLength: 源数据长度
// 返回: 目标字符串长度
extern "C" _declspec(dllexport)  int _cdecl gsmBytes2String(const unsigned char* pSrc, char* pDst, int nSrcLength);
// 发送短消息
// pSrc: 源PDU参数指针
extern "C" _declspec(dllexport)  BOOL _cdecl gsmSendMessage(const SM_PARAM* pSrc);
// 读取短消息
// 用+CMGL代替+CMGR，可一次性读出全部短消息
// pMsg: 短消息缓冲区，必须足够大
// 返回: 短消息条数
extern "C" _declspec(dllexport)  int _cdecl gsmReadMessage(SM_PARAM* pMsg);
// 删除短消息
// index: 短消息序号，从1开始
extern "C" _declspec(dllexport)  BOOL _cdecl gsmDeleteMessage(const int index);
// 打开串口
// pPort: 串口名称或设备路径，可用"COM1"或"\\.\COM1"两种方式，建议用后者
// nBaudRate: 波特率
// nParity: 奇偶校验
// nByteSize: 数据字节宽度
// nStopBits: 停止位
extern "C" _declspec(dllexport)  BOOL _cdecl OpenComm(const char* pPort, int nBaudRate, int nParity, int nByteSize, int nStopBits);
// 关闭串口
extern "C" _declspec(dllexport)  BOOL _cdecl CloseComm();
// 写串口
// pData: 待写的数据缓冲区指针
// nLength: 待写的数据长度
extern "C" _declspec(dllexport)  void _cdecl WriteComm(void* pData, int nLength);
// 读串口
// pData: 待读的数据缓冲区指针
// nLength: 待读的最大数据长度
// 返回: 实际读入的数据长度
extern "C" _declspec(dllexport)  int _cdecl ReadComm(void* pData, int nLength);

#endif