export.h

中国移动短信平台开发接口库

BOOL WINAPI Login(
				  LPCTSTR SystemID,				//用户标识 char [MAX_SMEI_SYSTEMID]
				  LPCTSTR Password				//密码 char[MAX_SMEI_PASSWORD]
				  );

BOOL WINAPI Login_R(LPCTSTR SystemID,			//用户标识 char [MAX_SMEI_SYSTEMID]
					LPCTSTR Password			//密码 char[MAX_SMEI_PASSWORD]
					);

BOOL WINAPI Logout();

int WINAPI SubmitSM(
			  unsigned char OrgTON,					//源地址号码类型
			  unsigned char OrgNPI,					//源地址编码方案
			  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
			  unsigned char DestTON,				//目标地址号码类型
			  unsigned char DestNPI,				//目标地址编码方案
			  LPCTSTR DestAddr,						//目标地址 char[MAX_ADDR_LEN]
			  unsigned char PRI,					//SM优先级
			  unsigned char DCS,					//数据编码方案
			  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
			  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
			  unsigned long Default_ID,				//缺省短消息
			  unsigned char UDHI,					//1表示UD为一个结构，0表示缺省
			  unsigned long UDLen,					//表示UD的长度
			  LPCTSTR UserData,						//用户信息，短消息正文
			  unsigned long* SM_ID,					//返回：短消息ID
			  unsigned char* FCS					//返回：失败原因
			  );

int WINAPI VPSubmitSM(
			  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
			  LPCTSTR DestAddr,						//目标地址 char[MAX_ADDR_LEN]
			  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
			  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
			  unsigned long Default_ID,				//缺省短消息
			  LPCTSTR UserData,						//用户信息，短消息正文
			  unsigned long* SM_ID					//返回：短消息ID
			  );

int WINAPI QuerySMStatus(
				   unsigned long SM_ID,				//短消息ID
				   unsigned char* OrgTON,			//返回：源地址号码类型
				   unsigned char* OrgNPI,			//返回：源地址编码方案
				   LPTSTR OrgAddr,					//返回：源地址 char[MAX_ADDR_LEN]
				   unsigned char* DestTON,			//返回：目标地址号码类型
				   unsigned char* DestNPI,			//返回：目标地址编码方案
				   LPTSTR DestAddr,					//返回：目标地址 char[MAX_ADDR_LEN]
				   LPTSTR Final_Date,				//返回：最后时间 char[MAX_TIMESTAMP_LEN]
				   unsigned char* SM_Status,		//返回：短消息状态
													//0 : WAITING_FOR_DELIVER 表示等待发送
													//1 : DELIVER_SUCCESS 表示成功发送
													//2 : DELIVER_FAIL 表示发送失败
				   unsigned char* Error_Code		//返回：错误代码
				   );

int WINAPI QuerySMDetail(
				   unsigned long SM_ID,				//短消息ID
				   unsigned char *OrgTON,			//返回：源地址号码类型
				   unsigned char *OrgNPI,			//返回：源地址编码方案
				   LPTSTR OrgAddr,					//返回：源地址 char[MAX_ADDR_LEN]
				   unsigned char* DestTON,			//返回：目标地址号码类型
				   unsigned char* DestNPI,			//返回：目标地址编码方案
				   LPTSTR DestAddr,					//返回：目标地址 char[MAX_ADDR_LEN]
				   unsigned char* PRI,				//返回：SM优先级
				   unsigned char* DCS,				//返回：数据编码方案
				   LPTSTR Schedule,					//返回：定时 char[MAX_TIMESTAMP_LEN]
				   LPTSTR Expire,					//返回：超时时间 char[MAX_TIMESTAMP_LEN]
				   LPTSTR Final,					//返回：最后时间 char[MAX_TIMESTAMP_LEN]
				   unsigned char* SM_Status,		//返回：短消息状态, 返回值定义同QuerySMStatus.
				   unsigned char* Error_Code,		//返回：错误代码
				   unsigned long Len,				//接收短消息长度，User_Data的大小不能小于此数
				   LPTSTR User_Data					//返回：短消息文本
				   );

int WINAPI CancelSM(
					 unsigned long SM_ID			//短消息ID
					 );

int WINAPI ReplaceSM(
					  unsigned long SM_ID,					//短消息ID
					  unsigned char OrgTON,					//源地址号码类型
					  unsigned char OrgNPI,					//源地址编码方案
					  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
					  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
					  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
					  unsigned char DCS,					//数据编码方案
					  unsigned long Default_ID,				//缺省短消息
					  unsigned long UDL,
					  LPCTSTR UserData						//用户信息，短消息正文
					  );

int WINAPI QuerySMS(
					unsigned char Dir,					//0:按源地址 1:按目标地址
					unsigned char TON,
					unsigned char NPI,
					LPCTSTR Addr,
					LPCTSTR DateTime,					//开始时间
					LPCTSTR FinaTime,					//结束时间
					unsigned char* Number,				//要查询的条数
					unsigned char* status,
					unsigned long* sm_id
					);

int WINAPI AddSubscriber(
						 unsigned char TON,					//号码类型
						 unsigned char NPI,					//编码方案
						 LPCTSTR SubID,						//用户标识 char[MAX_ADDR_LEN]
						 LPCTSTR SubName,					//用户姓名 char[MAX_ADDR_LEN]
						 LPCTSTR SubAddress,				//用户（通讯）地址 char[MAX_SUB_ADDRESS]
						 unsigned char MsType,				//手机类型
						 unsigned long Service,				//服务级别（未定义）
						 unsigned char bSM,					//是否提供短消息服务
						 unsigned long OCOS,				//最大下发数
						 unsigned long TCOS,				//最大提交数
						 unsigned short Reserve,			//保留
						 LPCTSTR Password					//密码 char [MAX_PASSWORD]
						 );

int WINAPI DeleteSubscriber(
							LPCTSTR SubID					//用户标识 char[MAX_ADDR_LEN]
							);

int WINAPI ModifySubscriber(
						 unsigned char TON,					//号码类型
						 unsigned char NPI,					//编码方案
						 LPCTSTR SubID,						//用户标识 char[MAX_ADDR_LEN]
						 LPCTSTR SubName,					//用户姓名 char[MAX_ADDR_LEN]
						 LPCTSTR SubAddress,				//用户地址 char[MAX_SUB_ADDRESS]
						 unsigned char MsType,				//手机类型
						 unsigned long Service,				//服务级别
						 unsigned char bSM,					//是否提供短消息服务
						 unsigned long OCOS,				//最大下发数
						 unsigned long TCOS,				//最大提交数
						 LPCTSTR Password					//密码 char [MAX_PASSWORD]
						 );

int WINAPI EnquireSubscriber(
							 LPCTSTR SubID,						//用户标识
							 unsigned char* TON,				//返回：号码类型
							 unsigned char* NPI,				//返回：编码方案
							 LPTSTR SubName,					//返回：用户姓名 char[MAX_ADDR_LEN]
							 LPTSTR SubAddress,					//返回：用户地址 char[MAX_SUB_ADDRESS]
							 unsigned long* Service,			//返回：服务级别
							 unsigned char* bSM,				//返回：是否提供短消息服务
							 unsigned long* OCOS,				//返回：最大下发数
							 unsigned long* TCOS,				//返回：最大提交数
							 LPTSTR Password					//返回：密码 char [MAX_PASSWORD]
							 );

int WINAPI EnquireLink();

int WINAPI HasDeliverMessage(
							 DWORD dwTimeOut					//超时时间，单位毫秒
							 );

int WINAPI GetDeliverSM(
						ULONG* sm_ID,							//返回：短讯ID
						unsigned char* DestTON,					//返回：目标地址号码类型
						unsigned char* DestNPI,					//返回：目标地址编码方案
						char* DestAddr,							//返回：目标地址
						unsigned char* OrgTON,					//返回：源地址号码类型
						unsigned char* OrgNPI,					//返回：源地址编码方案
						char* OrgAddr,							//返回：源地址
						unsigned char* PRI,						//返回：优先权
						unsigned char* PID,						//返回：协议类型
						unsigned char* DCS,						//返回：编码方案
						char* TimeStamp,						//返回：下发时间
						char* UserData							//返回：用户数据
						);

int WINAPI VPModifySubPassword(
					   LPCTSTR SubID,					//用户标识 char[MAX_ADDR_LEN]
					   LPCTSTR Password					//密码 char [MAX_PASSWORD]
					   );

int WINAPI GetErrorString(
						  int iErrorNum,				//错误代码
						  int iBuffSize,				//缓冲区大小
						  char* lpszBuff				//缓冲区指针
						  );

int WINAPI GetSMStatusString(
                             DWORD dwStatus,            // 状态值
                             int iBuffLen,              // 缓冲区大小
                             char* lpszBuff             // 缓冲区指针
                             );

int WINAPI SubmitA(
			  unsigned char OrgTON,					//源地址号码类型
			  unsigned char OrgNPI,					//源地址编码方案
			  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
			  unsigned char DestTON,				//目标地址号码类型
			  unsigned char DestNPI,				//目标地址编码方案
			  LPCTSTR DestAddr,						//目标地址 char[MAX_ADDR_LEN]
			  unsigned char PRI,					//SM优先级
			  unsigned char RD,						//当源地址和目的地址相同时，是否替换存在的短消息。
			  unsigned char RP,						//回应路径
			  unsigned char SRR,					//是否需要状态报告
			  unsigned char MR,						//消息索引
			  unsigned char DCS,					//数据编码方案
			  unsigned char PID,					//协议类型
			  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
			  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
			  unsigned long Default_ID,				//缺省短消息
			  unsigned char UDHI,					//1表示UD为一个结构，0表示缺省
			  unsigned long UDLen,					//表示UD的长度
			  LPCTSTR UserData,						//用户信息，短消息正文
			  unsigned long* SM_ID,					//返回：短消息ID
			  unsigned char* FCS					//返回：失败原因
			  );
//by ycl 2001.7.9 新增业务子类型
int WINAPI SubmitAEx(
			  unsigned char OrgTON,					//源地址号码类型
			  unsigned char OrgNPI,					//源地址编码方案
			  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
			  unsigned char DestTON,				//目标地址号码类型
			  unsigned char DestNPI,				//目标地址编码方案
			  LPCTSTR DestAddr,						//目标地址 char[MAX_ADDR_LEN]
			  unsigned char PRI,					//SM优先级
			  unsigned char RD,						//当源地址和目的地址相同时，是否替换存在的短消息。
			  unsigned char RP,						//回应路径
			  unsigned char SRR,					//是否需要状态报告
			  unsigned char MR,						//消息索引
			  unsigned char DCS,					//数据编码方案
			  unsigned char PID,					//协议类型
			  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
			  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
			  unsigned long Default_ID,				//缺省短消息
			  unsigned char UDHI,					//1表示UD为一个结构，0表示缺省
			  unsigned long UDLen,					//表示UD的长度
			  LPCTSTR UserData,						//用户信息，短消息正文
			  LPCTSTR sServiceType,                 //业务子类型 by ycl 2001.7.9
			  unsigned long* SM_ID,					//返回：短消息ID
			  unsigned char* FCS					//返回：失败原因
			  );
//nd by ycl

//by ycl 2001.9.26新增CMPP的计费字段
int WINAPI SubmitAExEx(
			  unsigned char OrgTON,					//源地址号码类型
			  unsigned char OrgNPI,					//源地址编码方案
			  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
			  unsigned char DestTON,				//目标地址号码类型
			  unsigned char DestNPI,				//目标地址编码方案
			  LPCTSTR DestAddr,/*update*/           //目的地址，SMPP时使用
			  unsigned char PRI,					//SM优先级
			  unsigned char RD,						//当源地址和目的地址相同时，是否替换存在的短消息。
			  unsigned char RP,						//回应路径
			  unsigned char SRR,					//是否需要状态报告
			  unsigned char MR,						//消息索引
			  unsigned char DCS,					//数据编码方案
			  unsigned char PID,					//协议类型
			  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
			  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
			  unsigned long Default_ID,				//缺省短消息
			  unsigned char UDHI,					//1表示UD为一个结构，0表示缺省
			  unsigned long UDLen,					//表示UD的长度
			  LPCTSTR UserData,						//用户信息，短消息正文
			  LPCTSTR sServiceType,                 //业务子类型 by ycl 2001.7.9
			  unsigned char* byMsgID,/*new*/        //MAX_MSG_ID,CMPP的字段，消息ID
			  unsigned char byPKTotal,/*new*/                  //相同Msg_id的消息总条数，从1开始
		  	  unsigned char byPKNumber,/*new*/                 //相同Msg_id的消息序号，从1开始
			  unsigned char byMsglevel,/*new*/                 //信息级别
			  unsigned char byFeeUserType,/*new*/              //计费用户类型字段，0：对目的终端MSISDN计费；1：对源终端MSISDN计费；2：对SP计费;3:表示本字段无效			  
			  LPCTSTR sSPID,/*new*/                 //MAX_SPID_LEN,信息内容来源
			  LPCTSTR sFeeType,/*new*/              //MAX_FEE_TYPE_LEN,资费类别
			  LPCTSTR sFeeAddr,/*new*/              //MAX_ADDR_LEN,被计费用户地址
			  LPCTSTR sFeeCode,/*new*/              //MAX_FEE_CODE_LEN,资费代码
			  unsigned char byUserNum,/*new*/                  //接收消息的用户数量
			  LPCTSTR sDestAddrs,/*new*/      //目的地址，最多100个，CMPP使用
			  unsigned long* SM_ID,					//返回：短消息ID
			  unsigned char* FCS					//返回：失败原因
			  );
//end by ycl
int WINAPI VPSubmitA(
			  LPCTSTR OrgAddr,						//源地址 char[MAX_ADDR_LEN]
			  LPCTSTR DestAddr,						//目标地址 char[MAX_ADDR_LEN]
			  unsigned char PID,					//协议类型
			  unsigned char DCS,					//编码方案
			  LPCTSTR Schedule,						//定时 char[MAX_TIMESTAMP_LEN]
			  LPCTSTR Expire,						//超时时间 char[MAX_TIMESTAMP_LEN]
			  unsigned long Default_ID,				//缺省短消息
			  LPCTSTR UserData,						//用户信息，短消息正文
			  unsigned long* SM_ID					//返回：短消息ID
			  );

int  WINAPI GSMConvertTextToData(
				LPCSTR pString,						//需要变换的源字符串指针
				unsigned char nDCS,					//指定变换的编码方案
				unsigned char* pData,				//接收缓冲区指针
				unsigned long* nLen					//用户数据的大小的指针，此是SUBMIT中UDL字段的长度，不是字节长度
				);

int  WINAPI GSMConvertDataToText(
				unsigned char* pData,				//编码后的数据
				unsigned long nLen,					//编码数据的实际大小，此项为协议的UDL项。
				unsigned char nDCS,					//编码数据的编码方案
				unsigned char nUDHI,				//协议的UDHI项，是否有结构头。
				char* pString						//解码的字符串缓冲区指针
				);

int WINAPI QuerySubscriber(
					 LPCTSTR SubID,						//用户标识
					 unsigned char* TON,				//返回：号码类型
					 unsigned char* NPI,				//返回：编码方案
					 LPTSTR SubName,					//返回：用户姓名 char[MAX_ADDR_LEN]
					 LPTSTR SubAddress,					//返回：用户地址 char[MAX_SUB_ADDRESS]
					 unsigned char* MsType,				//返回：手机类型
					 unsigned long* Service,			//返回：服务级别
					 unsigned char* bSM,				//返回：是否提供短消息服务
					 unsigned long* OCOS,				//返回：最大下发数
					 unsigned long* TCOS,				//返回：最大提交数
					 LPTSTR Password,					//返回：密码 char [MAX_PASSWORD]
					 LPTSTR RegTime						//返回：注册时间 char[20]
					 );

int WINAPI QuerySMStatusA(
						unsigned long SM_ID,			//短消息ID
						unsigned char OrgTON,			//源地址号码类型
						unsigned char OrgNPI,			//源地址编码方案
						LPCTSTR OrgAddr,				//源地址 char[MAX_ADDR_LEN]
						unsigned char* DestTON,			//返回：目标地址号码类型
						unsigned char* DestNPI,			//返回：目标地址编码方案
						LPTSTR DestAddr,				//返回：目标地址 char[MAX_ADDR_LEN]
						LPTSTR Final_date,				//返回：最后时间 char[MAX_TIMESTAMP_LEN]
						unsigned char* SM_Status,		//返回：短消息状态
														//0 : WAITING_FOR_DELIVER 表示等待发送
														//1 : DELIVER_SUCCESS 表示成功发送
														//2 : DELIVER_FAIL 表示发送失败
						unsigned char* Error_Code		//返回：错误代码
						);

int WINAPI CancelSMA(
					char cService_type,					//参见GSM3.39说明
					unsigned long SM_ID,				//短消息ID
					unsigned char OrgTON,				//源地址号码类型
					unsigned char OrgNPI,				//源地址编码方案
					LPCTSTR OrgAddr,					//源地址 char[MAX_ADDR_LEN]
					unsigned char DestTON,				//目标地址号码类型
					unsigned char DestNPI,				//目标地址编码方案
					LPCTSTR DestAddr					//目标地址 char[MAX_ADDR_LEN]