SmsFilterActionType Enumerazione

Definizione

Spazio dei nomi:

Windows.Devices.Sms

Valori che descrivono l'azione da eseguire su un filtro di messaggio.

Le app di messaggistica usano filtri SMS quando usano SMS per comunicare dati specifici dell'app che non devono necessariamente essere visualizzati all'utente. Si noti che i filtri vengono elaborati in un ordine fisso, in base al tipo di azione di filtro. Tutti i filtri AcceptImmediately vengono elaborati per primi, quindi tutti i filtri Drop e così via.

Nota

Questa funzionalità è disponibile solo per le app dell'operatore di telefonia mobile e le app UWP a cui è stato concesso l'accesso con privilegi dagli operatori di rete mobile, dalla scheda AHV mobile a banda larga o dall'OEM. Per altre informazioni, vedere Mobile Broadband.

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

Ereditarietà

Enum

SmsFilterActionType

Attributi

ContractVersionAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)
Funzionalità dell'app	cellularMessaging sms

Campi

Accept	3	I filtri con questo tipo di azione vengono applicati dopo i filtri Peek . I messaggi filtrati in questo tipo di azione vengono recapitati all'app. Una copia del messaggio può essere recapitata anche all'applicazione di messaggistica da visualizzare all'utente, se appropriato. Si noti che se più applicazioni registrano lo stesso filtro con questo tipo di azione, ogni applicazione ottiene la propria copia del messaggio. Nota L'app di messaggistica mostra solo messaggi di testo e trasmissione all'utente. Quindi la registrazione di un filtro Accept in un messaggio che non è testo né trasmissione non causerebbe che tale messaggio venga visualizzato all'utente. Per ricevere il messaggio SMS successivo, è necessario elaborare ogni messaggio filtrato chiamando Accetta. L'errore di accettare il messaggio è considerato un caso eccezionale (ad esempio la rimozione della batteria, l'arresto dell'applicazione o l'arresto anomalo dell'applicazione) e in tal caso il messaggio verrà ridistribuito al riavvio.
AcceptImmediately	0	Primo tipo di azione da eseguire. I messaggi filtrati in questo tipo di azione vengono recapitati all'applicazione e non vengono recapitati all'applicazione di messaggistica da visualizzare all'utente. Si noti che se più applicazioni registrano lo stesso filtro con questo tipo di azione, ogni applicazione ottiene la propria copia del messaggio. Per impedire all'applicazione di usare accidentalmente tutti i messaggi di testo dell'utente, è necessario specificare un requisito aggiuntivo per la regola di filtroSMS con il tipo di messaggio SMS Tipo di messaggio SMSAcceptImmediately per fornire al massimo uno TextMessagePrefixes con almeno 3 caratteri nel prefisso. Nota Per ricevere il messaggio SMS successivo, è necessario elaborare ogni messaggio filtrato chiamando Accetta. L'errore di accettare il messaggio è considerato un caso eccezionale (ad esempio la rimozione della batteria, l'arresto dell'applicazione o l'arresto anomalo dell'applicazione) e in tal caso il messaggio verrà ridistribuito al riavvio.
Drop	1	I filtri con questo tipo di azione vengono applicati dopo i filtri AcceptImmediately . I messaggi filtrati in questo tipo di azione vengono eliminati e non vengono eliminati né l'app di messaggistica né l'app di messaggistica ricevono il messaggio o qualsiasi notifica che un messaggio è arrivato ed è stato eliminato.
Peek	2	I filtri con questo tipo di azione vengono applicati dopo l'eliminazione dei filtri. Questo tipo di azione consente all'applicazione di controllare ogni messaggio e decidere quali vengono eliminati e quali continuare a essere elaborati o visualizzati all'utente. Nota È necessario elaborare ogni messaggio filtrato chiamando Drop o Accept entro un periodo massimo di timeout di 60 secondi. I filtri di anteprima devono essere usati dai filtri di posta indesiderata o dalle analisi di virus che richiedono un'ispezione dinamica del codice che non può essere eseguita usando i meccanismi di filtro esistenti forniti dalla regola di filtro SMS. L'uso di questo tipo di azione può rallentare il recapito dei messaggi SMS nel sistema in modo che l'applicazione debba elaborare il messaggio il più rapidamente possibile.

Esempio

(INVIO SMS e ricezione) [https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/SmsSendAndReceive]