SmsFilterActionType 枚举

定义

描述对消息筛选器执行的操作的值。

消息应用在使用短信来传达不一定要向用户显示的应用特定数据时,消息应用使用短信筛选器。 请注意,按筛选器操作类型按固定顺序处理筛选器。 首先处理所有 AcceptImmediately 筛选器,然后处理所有 删除 筛选器等。

注意

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

public enum class SmsFilterActionType
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
enum class SmsFilterActionType
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public enum SmsFilterActionType
var value = Windows.Devices.Sms.SmsFilterActionType.acceptImmediately
Public Enum SmsFilterActionType
继承
SmsFilterActionType
属性

Windows 要求

设备系列
Windows 10 (在 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox 中引入)
API contract
Windows.Foundation.UniversalApiContract (在 v1.0 中引入)
应用功能
cellularMessaging sms

字段

Accept 3

速览 筛选器后,将应用具有此操作类型的筛选器。 根据此操作类型筛选的消息将传送到你的应用。 也可以将消息的副本传递到消息应用程序,以便向用户显示(如果适用)。 请注意,如果多个应用程序向此操作类型注册相同的筛选器,则每个应用程序都将获取其自己的消息副本。

注意

消息应用仅向用户显示文本消息和广播消息。 因此,在既不是文本也不是广播的消息上注册 Accept 筛选器不会使该消息向用户显示。 若要接收下一条短信,需要通过调用 接受来处理每个筛选的消息。 不接受消息被视为异常情况(例如电池删除、应用程序停止或崩溃),在这种情况下,将在重启时重新传送消息。

AcceptImmediately 0

要执行的第一个操作类型。 根据此操作类型筛选的消息将传递到应用程序,不会传递到要向用户显示的消息传送应用程序。 请注意,如果多个应用程序向此操作类型注册相同的筛选器,则每个应用程序都将获取其自己的消息副本。 为了防止应用程序意外使用所有用户短信,短信筛选规则 还需要 短信类型 文本和 短信操作类型AcceptImmediately 提供至少一个 TextMessagePrefixes 前缀中至少有 3 个字符。

注意

若要接收下一条短信,需要通过调用 接受来处理每个筛选的消息。 不接受消息被视为异常情况(例如电池删除、应用程序停止或崩溃),在这种情况下,将在重启时重新传送消息。

Drop 1

AcceptImmediately 筛选器后,将应用具有此操作类型的筛选器。 根据此操作类型筛选的消息将被删除,你的应用和消息传送应用都不会收到消息或任何消息到达并被删除的通知。

Peek 2

Drop 筛选器后,将应用具有此操作类型的筛选器。 此操作类型允许应用程序检查每个消息,并决定删除哪些消息,以及继续处理或向用户显示哪些消息。

注意

需要通过调用 删除在最长超时期限为 60 秒内接受 来处理每个筛选的消息。 速览 筛选器应由垃圾邮件筛选器或病毒扫描使用,这些筛选器需要动态代码检查,这些筛选器无法使用 短信筛选规则提供的现有筛选机制来完成。 使用此操作类型可能会减慢系统中的短信传递速度,以便应用程序应尽快处理该消息。

示例

(短信发送和接收)[https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/SmsSendAndReceive]

适用于