SmsFilterActionType 列挙型

定義

名前空間:

Windows.Devices.Sms

メッセージ フィルターで実行するアクションを表す値。

メッセージング アプリは、SMS を使用して、ユーザーに表示されることを意図していないアプリ固有のデータを通信するときに SMS フィルターを使用します。 フィルターは、フィルター アクションの種類によって固定順序で処理されることに注意してください。 すべての AcceptImmediately フィルターが最初に処理され、次にすべての ドロップ フィルターが処理されます。

手記

この機能は、モバイル ネットワーク オペレーター、モバイル ブロードバンド アダプター 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 メッセージの種類 Text SMS フィルター ルールを し、SMS アクションの種類を AcceptImmediately して、少なくとも 1 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]