SmsFilterActionType 列舉

定義

命名空間:

Windows.Devices.Sms

值，描述在訊息篩選上要採取的動作。

當傳訊應用程式使用 SMS 來傳達不一定要向使用者顯示的應用程式特定資料時，傳訊應用程式會使用 SMS 篩選器。 請注意，篩選準則會依固定順序依篩選動作類型進行處理。 系統會先處理所有 AcceptImmediately 篩選準則，然後再處理所有 Drop 篩選準則等等。

注意

這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。

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	此動作類型的篩選會在 [查看 篩選] 之後套用。 在此動作類型上篩選的訊息會傳遞至您的應用程式。 您也可以將訊息複本傳遞給傳訊應用程式，以視需要向使用者顯示。 請注意，如果多個應用程式使用此動作類型註冊相同的篩選，則每個應用程式都會取得自己的訊息複本。 注意 傳訊應用程式只會向使用者顯示文字和廣播訊息。 因此，在不是文字或廣播的訊息上註冊 Accept 篩選，並不會對使用者顯示該訊息。 若要接收下一個 SMS 訊息，您必須呼叫 Accept來處理每個篩選過的訊息。 無法接受訊息會被視為例外狀況， (例如電池移除、應用程式停止或當機) ，在此情況下，會在重新開機時重新傳遞訊息。
AcceptImmediately	0	要採取的第一個動作類型。 在此動作類型上篩選的訊息會傳遞至您的應用程式，而且不會傳遞至要向使用者顯示的傳訊應用程式。 請注意，如果多個應用程式使用此動作類型註冊相同的篩選，則每個應用程式都會取得自己的訊息複本。 若要防止應用程式不小心取用所有使用者簡訊，SMS 篩選規則 有 SMS 訊息類型 Text 和 SMS 動作類型AcceptImmediately 的額外需求，以提供至少 3 個字元在前置詞中的一個 TextMessagePrefixes 。 注意 若要接收下一個 SMS 訊息，您必須呼叫 Accept來處理每個篩選過的訊息。 無法接受訊息會被視為例外狀況， (例如電池移除、應用程式停止或當機) ，在此情況下，會在重新開機時重新傳遞訊息。
Drop	1	此動作類型的篩選會在 AcceptImmediately 篩選之後套用。 在此動作類型上篩選的訊息會遭到捨棄，而且您的應用程式和傳訊應用程式都不會收到訊息或任何訊息送達且已卸載的通知。
Peek	2	此動作類型的篩選會在 [置放 篩選] 之後套用。 此動作類型可讓您的應用程式檢查每個訊息，並決定要捨棄哪些訊息，以及要繼續處理或向使用者顯示哪些訊息。 注意 您必須在 60 秒的最大逾時期間內呼叫 Drop 或 Accept 來處理每個篩選過的訊息。 垃圾郵件 篩選器或病毒掃描預期會使用預覽篩選準則，這需要動態程式碼檢查，無法使用 SMS 篩選規則所提供的現有篩選機制來完成。 使用此動作類型可能會使系統中的 SMS 訊息傳遞變慢，因此您的應用程式應該儘快處理訊息。

範例

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