SmsFilterActionType Перечисление

Определение

Пространство имен:

Windows.Devices.Sms

Значения, описывающие действие, выполняемое с фильтром сообщений.

Приложения для обмена сообщениями используют фильтры SMS, когда они используют SMS для передачи данных конкретного приложения, которые не обязательно предназначены для отображения пользователю. Обратите внимание, что фильтры обрабатываются в фиксированном порядке по типу действия фильтра. Сначала обрабатываются все фильтры AcceptImmediately , затем все фильтры drop и т. д.

Примечание

Эта функция доступна только для приложений мобильных операторов и приложений 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

Наследование

Enum

SmsFilterActionType

Атрибуты

ContractVersionAttribute

Требования к 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	Фильтры с этим типом действия применяются после просмотра фильтров. Сообщения, отфильтрованные по этому типу действия, доставляются в приложение. Копию сообщения также можно доставить в приложение для обмена сообщениями, которое будет отображаться пользователю, если это необходимо. Обратите внимание, что если несколько приложений регистрируют один и тот же фильтр с этим типом действия, каждое приложение получает собственную копию сообщения. Примечание Приложение для обмена сообщениями отображает пользователю только текстовые и широковещательные сообщения. Таким образом, регистрация фильтра "Принять" для сообщения, которое не является ни текстом, ни широковещательным, не приведет к тому, что это сообщение не будет отображаться пользователю. Чтобы получить следующее SMS-сообщение, необходимо обработать каждое отфильтрованное сообщение, вызвав метод Accept. Невозможность принять сообщение считается исключительным случаем (например, удаление батареи, остановка приложения или сбой), и в этом случае сообщение будет доставлено повторно при перезапуске.
AcceptImmediately	0	Первый тип выполняемого действия. Сообщения, отфильтрованные по этому типу действия, доставляются в приложение и не доставляются в приложение для обмена сообщениями для отображения пользователю. Обратите внимание, что если несколько приложений регистрируют один и тот же фильтр с этим типом действия, каждое приложение получает собственную копию сообщения. Чтобы предотвратить случайное использование приложением всех текстовых сообщений пользователя, существует дополнительное требование к правилу фильтрации SMS с типом SMS-сообщений Текст и типом действия SMSAcceptImmediately , чтобы предоставить один textMessagePrefixes с минимальными 3 символами в префиксе. Примечание Чтобы получить следующее SMS-сообщение, необходимо обработать каждое отфильтрованное сообщение, вызвав метод Accept. Невозможность принять сообщение считается исключительным случаем (например, удаление батареи, остановка приложения или сбой), и в этом случае сообщение будет доставлено повторно при перезапуске.
Drop	1	Фильтры с этим типом действия применяются после фильтров AcceptImmediately . Сообщения, отфильтрованные по этому типу действия, удаляются, и ни ваше приложение, ни приложение для обмена сообщениями не получают ни сообщения, ни уведомления о том, что сообщение поступило и было удалено.
Peek	2	Фильтры с этим типом действия применяются после удаления фильтров. Этот тип действия позволяет приложению проверять каждое сообщение и решать, какие из них будут удалены, а какие продолжают обрабатываться или отображаться пользователю. Примечание Необходимо обработать каждое отфильтрованное сообщение, вызвав метод Drop или Accept в течение максимального времени ожидания в 60 секунд. Фильтры просмотра, как ожидается, будут использоваться фильтрами нежелательной почты или вирусами, которые требуют динамической проверки кода, которая не может быть выполнена с помощью существующих механизмов фильтрации, предоставляемых правилом фильтрации SMS. Использование этого типа действия может замедлить доставку SMS-сообщений в системе, чтобы приложение обработало сообщение как можно быстрее.

Примеры

(отправка и получение SMS) [https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/SmsSendAndReceive]