通过

IMbnSms：：SmsRead 方法 (mbnapi.h)

  • 项目

重要

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

从设备读取一组短信。

语法

HRESULT SmsRead(
  [in]  MBN_SMS_FILTER *smsFilter,
  [in]  MBN_SMS_FORMAT smsFormat,
  [out] ULONG          *requestID
);

parameters

[in] smsFilter

指向 MBN_SMS_FILTER 结构的指针，该结构定义要读取的消息集。

[in] smsFormat

一个MBN_SMS_FORMAT值，该值指定应读取短信的格式。

对于 GSM 设备，应始终 MBN_SMS_FORMAT_PDU。

对于 CDMA 设备，如果将其指定为 MBN_SMS_FORMAT_PDU，则设备将读取二进制模式 CDMA 消息。 如果指定为MBN_SMS_FORMAT_TEXT，则设备将读取文本模式 CDMA 消息。 如果设备不支持指定的格式，则可能会返回错误代码。

[out] requestID

指向移动宽带服务颁发的用于标识此请求的请求 ID 的指针。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在此系统上运行。
E_HANDLE
 接口无效，很可能是因为设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 移动宽带设备很可能已从系统中删除。
E_INVALIDARG
 smsFormat 或 smsFilter 无效。

注解

使用 smsFilter，应用程序可以指定基本筛选器，例如新消息、草稿消息或使用索引的特定消息。 可以通过集成基本筛选器的组合来使用复杂筛选器。 所有接口都支持基于索引的筛选器和新的消息类型筛选器。 对于某些接口，对其他筛选器的支持是可选的。 如果不支持指定的筛选器，则操作完成回调函数将返回 E_MBN_STATUS_FILTER_NOT_SUPPORTED状态。

这是将立即返回的异步操作。 如果方法返回时没有错误，则移动宽带服务将调用 IMbnSmsEvents 接口的 OnSmsReadComplete 方法。

要求

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

另请参阅

IMbnSms