通过

IMbnSms：：GetSmsStatus 方法 (mbnapi.h)

  • 项目

重要

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

获取设备的短信状态。

语法

HRESULT GetSmsStatus(
  [out] MBN_SMS_STATUS_INFO *smsStatusInfo
);

parameters

[out] smsStatusInfo

指向 MBN_SMS_STATUS_INFO 结构的指针，其中包含设备的状态信息。

返回值

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

返回代码 说明
S_OK
 该方法已成功完成。
E_PENDING
 短信状态不可用。 移动宽带服务正在探测设备中的信息。 可以通过注册 IMbnSmsEvents 接口的 OnSmsStatusChange 方法，在短信状态可用时通知调用应用程序。
E_MBN_PIN_REQUIRED
 需要 PIN 才能获取此信息。
E_MBN_SIM_NOT_INSERTED
 设备中未插入 SIM 卡。
E_MBN_BAD_SIM
 设备中插入了错误的 SIM 卡。

注解

对于可恢复的错误（如 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM），移动宽带服务将在错误条件结束时再次查询设备以获取此信息。 例如，如果设备需要输入 PIN 才能检索此信息，则它将返回 E_MBN_PIN_REQUIRED。 当应用程序输入 PIN 来解锁设备时，移动宽带服务将再次尝试从设备获取此信息。 移动宽带服务将调用 IMbnSmsEvents 接口的 OnSmsStatusChange 方法

由于系统收到新消息，SMS 消息存储状态可能会更改。 在消息存储状态发生任何更改时，移动宽带服务将调用 IMbnSmsEvent 接口的 OnSmsStatusChange 方法。

应用程序发出的操作（如读取或删除消息）可能会在MBN_SMS_STATUS_INFO结构中重置标志。 此重置导致的 SMS 存储更改不会导致调用任何通知方法。

要求

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

另请参阅

IMbnSms