Windows.Devices.Sms 命名空间

提供发送和接收短信服务 (短信) 消息、筛选传入消息、以静默方式发送消息的功能，以及查询有关移动宽带短信设备的属性的功能。 使用此 API 实现移动运营商 (MO) 应用程序，这些应用程序使用应用定向短信来实现 MO 功能，例如视觉语音邮件应用。

如果要开发内置消息传递应用的替代方法，则不建议使用此 API。 相反，你应该使用 Windows.AppModel.Chat API 来开发消息传递应用。 聊天 API 维护消息的通用数据存储，以便使用聊天 API 的所有应用都显示一致的消息视图。 Windows.Devices.Sms 不提供此类数据存储，实际上使用它可能会干扰将短信传递到使用聊天 API 的应用。

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

请注意，此命名空间中的多个类仅支持用于维护在早期版本的 Windows 中使用它的旧桌面应用;如果使用旧版支持类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发用于Windows 10的新应用，请不要使用旧版支持类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的成员。

类

DeleteSmsMessageOperation	为单个消息启用启动、跟踪和结束异步消息删除操作。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
DeleteSmsMessagesOperation	启用对多条消息的启动、跟踪和结束异步短信删除操作。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
GetSmsDeviceOperation	异步检索 SmsDevice 对象。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
GetSmsMessageOperation	支持从短信存储区检索消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
GetSmsMessagesOperation	支持检索消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SendSmsMessageOperation	启用消息发送。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsAppMessage	用于操作短信应用程序消息的接口。 应用程序消息是不能描述为任何其他消息类型的消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsBinaryMessage	表示原始 PDU 格式的短信。 数据格式因消息格式 (format 属性) 的值指示为 GSM 还是 CDMA 而有所不同。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsBroadcastMessage	表示广播短信。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsDevice	支持移动宽带短信设备的操作。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsDevice2	扩展 SmsDevice 类，并支持移动宽带短信设备的操作。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsDeviceMessageStore	提供对 SMS 设备上存储的消息的访问，以及有关消息存储的信息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsFilterRule	描述短信筛选规则。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsFilterRules	SmsFilterRule 实例的集合。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsMessageReceivedEventArgs	为 ISmsBinaryMessage 事件处理程序提供数据。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsMessageReceivedTriggerDetails	包含收到短信时引发的事件的事件详细信息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsMessageRegistration	用于表示已注册消息筛选器的类。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsReceivedEventDetails	向后台工作项显示短信事件的详细信息，该工作项在应用挂起时处理消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsSendMessageResult	封装调用 SmsDevice2.SendMessageAndGetResultAsync 的结果。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsStatusMessage	封装短信状态消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 若要访问收到的状态消息，请创建由 SmsMessageReceived 事件触发的后台任务。 在该任务中，首先使用 SmsMessageReceivedTriggerDetails.MessageType 确定消息是状态消息，然后使用 SmsMessageReceivedTriggerDetails.StatusMessage 属性访问此类的实例。
SmsTextMessage	管理解码的短信，提供对消息纯文本正文的直接访问，以及密钥标头属性（如时间戳）。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsTextMessage2	封装解码的短信。 首选此类而不是较旧的 SmsTextMessage 类。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 若要发送文本消息，请构造此类的实例，设置所有适当的字段，并使用 SmsDevice2.SendMessageAndGetResultAsync 发送。 若要访问收到的短信，请创建由 SmsMessageReceived 事件触发的后台任务。 在该任务中，首先使用 SmsMessageReceivedTriggerDetails.MessageType 确定消息是文本消息，然后使用 SmsMessageReceivedTriggerDetails.TextMessage 属性访问此类的实例。
SmsVoicemailMessage	封装短信语音邮件。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsWapMessage	表示短信 WAP 推送消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。

结构

SmsEncodedLength

此结构表示有关 SmsTextMessage 对象编码为 PDU 时其长度的信息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。

接口

ISmsBinaryMessage	此接口提供对短信的原始二进制格式的访问。 消息存储在行业标准协议说明单元中， (PDU) 格式 (请参阅 SMS 规范 GSM 03.40) 。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
ISmsDevice	此接口控制移动宽带短信设备。 它是设备上短信服务的主要入口点。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
ISmsMessage	此接口由支持的所有类型的短信实现。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
ISmsMessageBase	此接口为所有短信类型指定基本功能。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
ISmsTextMessage	此接口操作解码的短信。 它提供对消息纯文本正文以及密钥标头属性（如时间戳）的直接访问。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。

枚举

CellularClass	此枚举类型定义设备中的无线电标准类型。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsBroadcastType	描述广播 (紧急警报) 消息类型的值。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsDataFormat	此枚举类型标识 PDU) 缓冲区 (给定协议说明单元的格式。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsDeviceStatus	包含一个值，该值指示 SMS 设备是否准备好参与手机网络流量操作。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsEncoding	此枚举类型用于确定发送或计算 SmsTextMessage 对象的长度的编码算法。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsFilterActionType	描述要对消息筛选器执行的操作的值。 当消息应用使用短信来传达不一定向用户显示的应用特定数据时，它们会使用短信筛选器。 请注意，按筛选器操作类型按固定顺序处理筛选器。 首先处理所有 AcceptImmediately 筛选器，然后处理所有 Drop 筛选器，依此类处理。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsGeographicalScope	描述单元格广播消息的地理范围的值。
SmsMessageClass	此枚举类型指定消息的消息类。 消息类通常源自网络，而不是移动设备。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsMessageFilter	此枚举类型指定对执行操作的设备消息存储中的哪些消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。
SmsMessageType	此枚举类型定义短信的格式。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsModemErrorCode	描述 SmsSendMessageResult 中 SMS 调制解调器的错误代码的值。

委托

SmsDeviceStatusChangedEventHandler	当短信设备上的状态更改时，将调用此处理程序。 当调用方希望在设备上发生重大状态更改时收到通知时，应实现此操作。 例如，调用方可能想知道设备何时准备好发送和接收消息。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。
SmsMessageReceivedEventHandler	收到新的二进制消息时，将调用此事件处理程序。 当调用方想要处理来自给定短信设备的新二进制消息时，应实现此要求。 注意 此功能仅适用于由移动网络运营商、移动宽带适配器 IHV 或 OEM 授予特权访问权限的移动运营商应用和 UWP 应用。 有关详细信息，请参阅 移动宽带。 注意 支持此类及其方法维护在早期版本的 Windows 中使用它的旧桌面应用。 如果确实使用此类，则必须在应用的清单中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果要开发适用于 Windows 的新应用，请不要使用此类。 请改用此命名空间中不需要 Windows.Devices.Sms.LegacySmsApiContract 的 API。

注解

若要在收到短信时通知后台任务，请处理 Windows.ApplicationModel.Background.SmsMessageReceivedTrigger。

另请参阅

• 应用功能声明
• 短信发送和接收示例
• 短信发送和接收示例 (Windows 10)