SmsFilterActionType Enumeration

Definition

Namespace:

Windows.Devices.Sms

Werte, die die Aktion beschreiben, die für einen Nachrichtenfilter ausgeführt werden soll.

Messaging-Apps verwenden SMS-Filter, wenn sie SMS verwenden, um appspezifische Daten zu kommunizieren, die dem Benutzer nicht unbedingt angezeigt werden sollen. Beachten Sie, dass Filter in einer festen Reihenfolge nach Filteraktionstyp verarbeitet werden. Alle AcceptImmediately-Filter werden zuerst verarbeitet, dann alle Drop-Filter usw.

Hinweis

Diese Funktionalität steht nur für Apps von Mobilfunkanbietern und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber, mobile Breitbandadapter IHV oder OEM zur Verfügung. Weitere Informationen finden Sie unter Mobiles Breitband.

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

Vererbung

Enum

SmsFilterActionType

Attribute

ContractVersionAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
App-Funktionen	cellularMessaging sms

Felder

Accept	3	Filter mit diesem Aktionstyp werden nach Peek-Filtern angewendet. Nach diesem Aktionstyp gefilterte Nachrichten werden an Ihre App übermittelt. Eine Kopie der Nachricht kann auch an die Messaginganwendung übermittelt werden, um dem Benutzer angezeigt zu werden. Beachten Sie, dass jede Anwendung eine eigene Kopie der Nachricht erhält, wenn mehrere Anwendungen denselben Filter bei diesem Aktionstyp registrieren. Hinweis Die Messaging-App zeigt dem Benutzer nur Text- und Broadcastnachrichten an. Das Registrieren eines Accept-Filters für eine Nachricht, die weder Text noch Broadcast ist, würde also nicht dazu führen, dass diese Nachricht dem Benutzer angezeigt wird. Um die nächste SMS-Nachricht zu erhalten, müssen Sie jede gefilterte Nachricht verarbeiten, indem Sie Accept aufrufen. Die Nichtannahme der Nachricht wird als Ausnahmefall betrachtet (z. B. Batterieentfernung, Anwendungsstopp oder Absturz), und in diesem Fall wird die Nachricht beim Neustart erneut zugestellt.
AcceptImmediately	0	Der erste Aktionstyp, der ausgeführt werden soll. Nach diesem Aktionstyp gefilterte Nachrichten werden an Ihre Anwendung übermittelt und nicht an die Messaginganwendung übermittelt, um dem Benutzer angezeigt zu werden. Beachten Sie, dass jede Anwendung eine eigene Kopie der Nachricht erhält, wenn mehrere Anwendungen denselben Filter bei diesem Aktionstyp registrieren. Um zu verhindern, dass die Anwendung versehentlich alle Benutzer-Textnachrichten verwendet, ist eine zusätzliche Anforderung für die SMS-Filterregel mit dem SMS-Nachrichtentyp Text und dem SMS-AktionstypAcceptImmediately erforderlich, um mindestens eine TextMessagePrefixes mit mindestens 3 Zeichen im Präfix bereitzustellen. Hinweis Um die nächste SMS-Nachricht zu erhalten, müssen Sie jede gefilterte Nachricht verarbeiten, indem Sie Accept aufrufen. Die Nichtannahme der Nachricht wird als Ausnahmefall betrachtet (z. B. Batterieentfernung, Anwendungsstopp oder Absturz), und in diesem Fall wird die Nachricht beim Neustart erneut zugestellt.
Drop	1	Filter mit diesem Aktionstyp werden nach AcceptImmediately-Filtern angewendet. Nach diesem Aktionstyp gefilterte Nachrichten werden gelöscht, und weder Ihre App noch die Messaging-App erhalten die Nachricht oder eine Benachrichtigung, dass eine Nachricht eingegangen und gelöscht wurde.
Peek	2	Filter mit diesem Aktionstyp werden nach dem Löschen von Filtern angewendet. Mit diesem Aktionstyp kann Ihre Anwendung jede Nachricht überprüfen und entscheiden, welche gelöscht und welche weiter verarbeitet oder dem Benutzer angezeigt werden. Hinweis Sie müssen jede gefilterte Nachricht verarbeiten, indem Sie entweder Drop oder Accept innerhalb eines maximalen Timeoutzeitraums von 60 Sekunden aufrufen. Peek-Filter werden voraussichtlich von Spamfiltern oder Virenscans verwendet, die eine dynamische Codeüberprüfung erfordern, die nicht mit den vorhandenen Filtermechanismen durchgeführt werden kann, die von der SMS-Filterregel bereitgestellt werden. Die Verwendung dieses Aktionstyps kann die SMS-Nachrichtenübermittlung im System verlangsamen, sodass Ihre Anwendung die Nachricht so schnell wie möglich verarbeiten sollte.

Beispiele

(Senden und Empfangen von SMS) [https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/SmsSendAndReceive]