ISmsDevice 接口

定义

此接口控制移动宽带短信设备。 它是设备上短信服务的主要入口点。

注意

此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息,请参阅 移动宽带

public interface class ISmsDevice
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
struct ISmsDevice
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
/// [Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
struct ISmsDevice
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
public interface ISmsDevice
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
[Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
public interface ISmsDevice
Public Interface ISmsDevice
派生
属性

Windows 要求

设备系列
Windows Desktop Extension SDK (在 10.0.10240.0 中引入)
API contract
Windows.Devices.Sms.LegacySmsApiContract (在 v1.0 中引入)
应用功能
cellularMessaging sms

属性

AccountPhoneNumber

返回与短信设备关联的电话号码。 电话号码可用于将传入邮件与帐户关联,还可以将外部存储机制(例如帐户收件箱)关联。

CellularClass

返回短信设备的手机网络类。 类可用于确定哪些编码是合适的或有效的设备限制。

DeviceStatus

返回短信设备的状态,指示设备是否已准备就绪。 它还会确定设备未准备就绪时存在哪些类型的问题。

MessageStore

访问设备上的消息存储。 存储会保留消息,直到客户端可以检索它们。 例如,在某些设备上,存储可能对应于短信的 SIM 存储。

方法

CalculateLength(SmsTextMessage)

估计指定文本消息的传输消息长度。 对于想要指示网络上发送多少条消息以携带完整消息文本的客户端,此估计值非常有用。

SendMessageAsync(ISmsMessage)

使用短信设备异步发送消息。 方法是异步的,因为发送操作可能不会立即发生。 异步操作对象将立即返回。

事件

SmsDeviceStatusChanged

设置在 SMS 设备的状态更改时调用的事件处理程序。

SmsMessageReceived

设置在设备收到新文本消息时要调用的事件处理程序。

适用于