IMbnSmsEvents：：OnSmsReadComplete 方法 (mbnapi.h)

  • 项目

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的 Windows 运行时 API。

指示消息读取操作完成的通知方法。

语法

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

parameters

[in] sms

表示完成操作的消息存储的 IMbnSms 接口。

[in] smsFormat

定义短信格式 的MBN_SMS_FORMAT 值。

[in] readMsgs

从设备读取的消息数组。

[in] moreMsgs

一个布尔值，指示是否仍有更多消息正在处理。 如果为 TRUE，则将重复调用 OnSmsReadComplete ，直到没有更多消息且 更多Msgs 为 FALSE。

[in] requestID

由移动宽带服务分配的请求 ID，用于标识消息读取操作。

[in] status

指示操作结果的状态代码。

调用应用程序可能需要以下值之一。

值 含义
S_OK
 操作成功。
E_MBN_SIM_NOT_INSERTED
 设备中没有 SIM 卡。
E_MBN_BAD_SIM
 设备中有错误的 SIM 卡。
E_MBN_PIN_REQUIRED
 需要 PIN 才能完成操作。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持短信操作或特定短信格式。
E_MBN_SMS_MEMORY_FAILURE
 短信内存失败。
E_MBN_SMS_INVALID_MEMORY_INDEX
 没有具有所请求值的内存索引。
E_MBN_SMS_FILTER_NOT_SUPPORTED
 设备不支持请求的筛选器。

返回值

此方法必须返回 S_OK。

注解

对于 GSM 设备，调用应用程序应在 iMbnSmsReadMsgPdu 接口的 readMsgs 中的每个元素上调用 QueryInterface。

对于 CDMA 设备，如果MBN_SMS_FORMAT_TEXTsmsFormat，则应用程序应为 IMbnSmsReadMsgTextCdma 接口调用 QueryInterface;否则，如果MBN_SMS_FORMAT_PDU smsFormat，则应用程序应为 IMbnSmsReadMsgPdu 接口调用 QueryInterface。

如果读取请求导致读取大量消息，则可以重复调用 OnSmsReadComplete ，直到 moreMsgs 指示不再有要读取的消息。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnSmsEvents