ITAPI_SendSMS()
说明:
此方法用于从手持设备发送 SMS 消息。该函数可以用来向其它手持设备的特定 BREW 应用程序发送文本消息,或者向其它手持设备发送通用文本消息。 它将把消息发送到目标移动号码或电子邮件 ID。调用此函数后,它可能会在 BREW 应用程序中产生 SUSPEND/RESUME 序列。 手持设备发送 SMS 消息时将对它进行初始化。
控制序列流程如下:
应用程序调用 ITAPI_SendSMS(pITapi,pszDst,pszMsg,0,MyNotify,pMe)
手持设备开始发送 SMS 消息
应用程序接收 EVT_APP_SUSPEND
在发送消息的状态下调用 pfn 指定的通知函数
应用程序接收 EVT_APP_RESUME
如果应用程序希望显示通知信息,则建议在调用通知函数时存储状态,然后在收到 EVT_APP_RESUME 时显示该状态。
原型:
int ITAPI_SendSMS
(
ITAPI *pITapi,
const char * pszDst,
const char * pszMsg,
AEECLSID clsDst,
PFNSMSSTATUS pfn,
void *pUser
)
参数:
pITapi ?指向 ITAPI 接口对象的指针 ?
pszDst ?发送消息的目标号码或电子邮件 ID。 如果将其设为 NULL,并且 clsDst 非零,则此函数将向本地手持设备上的应用程序 (clsDst) 发送 EVT_APP_MESSAGE 事件,而该事件的 dwParam 将包含 pszMsg。 在此情况下,该函数的返回值与 ISHELL_SendEvent() 的返回值相同。 由于是本地发送消息,因此不会调用通知函数。 ?
pszMsg ?要发送至目标移动设备的文本消息。 如果设为 NULL,则函数将返回 EBADPARM ?
clsID ?如果非零,则它指定目标移动设备上接收该消息的 BREW 应用程序的类 ID ?
pfn ?通知 SMS 消息发送状态所调用的通知函数 ?
pUser ?发送至通知函数的用户数据
示例:
ITAPI_SendSMS (pITapi, "8581112222", "Hello World", 0, MyMOSMSNotify, pMe );
?
ITAPI_SendSMS ( pITapi, "foo@sample.com", "Hello World", 0, MyMOSMSNotify, pMe ); ?
返回值:
如果成功,则返回 SUCCESS。 将消息发送至其它手持设备后,使用状态调用该通知函数。 传送至通知函数的状态可能为 SUCCESS 或 Failure。
如果电话正忙,无法发送该 SMS,则返回 EITEMBUSY。 通常,只允许存在一个未完成的 SMS 消息。 除非已发送该消息,否则不可以发送其它消息。
如果 pszMsg 为 NULL,或 pszDst 和 clsDst 均设为 NULL,则返回 EBADPARM。
如果此手持设备未启用 TAPI,则返回 EBADCLASS。
如果发送 SMS 时发生常规故障,则返回 EFAILED。
示例:
ITAPI_SendSMS(pITapi, "8581112222", "Hello World", 0, MyMOSMSNotify, pMe);
ITAPI_SendSMS(pITapi, "foo@sample.com", "Hello World",0,MyMOSMSNotify,pMe);
说明:
此方法用于从手持设备发送 SMS 消息。该函数可以用来向其它手持设备的特定 BREW 应用程序发送文本消息,或者向其它手持设备发送通用文本消息。 它将把消息发送到目标移动号码或电子邮件 ID。调用此函数后,它可能会在 BREW 应用程序中产生 SUSPEND/RESUME 序列。 手持设备发送 SMS 消息时将对它进行初始化。
控制序列流程如下:
应用程序调用 ITAPI_SendSMS(pITapi,pszDst,pszMsg,0,MyNotify,pMe)
手持设备开始发送 SMS 消息
应用程序接收 EVT_APP_SUSPEND
在发送消息的状态下调用 pfn 指定的通知函数
应用程序接收 EVT_APP_RESUME
如果应用程序希望显示通知信息,则建议在调用通知函数时存储状态,然后在收到 EVT_APP_RESUME 时显示该状态。
原型:
int ITAPI_SendSMS
(
ITAPI *pITapi,
const char * pszDst,
const char * pszMsg,
AEECLSID clsDst,
PFNSMSSTATUS pfn,
void *pUser
)
参数:
pITapi ?指向 ITAPI 接口对象的指针 ?
pszDst ?发送消息的目标号码或电子邮件 ID。 如果将其设为 NULL,并且 clsDst 非零,则此函数将向本地手持设备上的应用程序 (clsDst) 发送 EVT_APP_MESSAGE 事件,而该事件的 dwParam 将包含 pszMsg。 在此情况下,该函数的返回值与 ISHELL_SendEvent() 的返回值相同。 由于是本地发送消息,因此不会调用通知函数。 ?
pszMsg ?要发送至目标移动设备的文本消息。 如果设为 NULL,则函数将返回 EBADPARM ?
clsID ?如果非零,则它指定目标移动设备上接收该消息的 BREW 应用程序的类 ID ?
pfn ?通知 SMS 消息发送状态所调用的通知函数 ?
pUser ?发送至通知函数的用户数据
示例:
ITAPI_SendSMS (pITapi, "8581112222", "Hello World", 0, MyMOSMSNotify, pMe );
?
ITAPI_SendSMS ( pITapi, "foo@sample.com", "Hello World", 0, MyMOSMSNotify, pMe ); ?
返回值:
如果成功,则返回 SUCCESS。 将消息发送至其它手持设备后,使用状态调用该通知函数。 传送至通知函数的状态可能为 SUCCESS 或 Failure。
如果电话正忙,无法发送该 SMS,则返回 EITEMBUSY。 通常,只允许存在一个未完成的 SMS 消息。 除非已发送该消息,否则不可以发送其它消息。
如果 pszMsg 为 NULL,或 pszDst 和 clsDst 均设为 NULL,则返回 EBADPARM。
如果此手持设备未启用 TAPI,则返回 EBADCLASS。
如果发送 SMS 时发生常规故障,则返回 EFAILED。
示例:
ITAPI_SendSMS(pITapi, "8581112222", "Hello World", 0, MyMOSMSNotify, pMe);
ITAPI_SendSMS(pITapi, "foo@sample.com", "Hello World",0,MyMOSMSNotify,pMe);