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 メッセージの種類が [テキスト] および [SMS アクションの種類] AcceptImmediately の SMS フィルター 規則に対して、プレフィックスに少なくとも 3 文字の TextMessagePrefixes を少なくとも 1 つ提供する追加の要件があります。 注意 次の SMS メッセージを受信するには、 Accept を呼び出してフィルター処理された各メッセージを処理する必要があります。 メッセージの受け入れ失敗は、例外的なケース (バッテリーの取り外し、アプリケーションの停止、クラッシュなど) と見なされ、その場合、再起動時にメッセージが再配信されます。
Drop	1	このアクションの種類のフィルターは、 AcceptImmediately フィルターの後に適用されます。 このアクションの種類でフィルター処理されたメッセージは削除され、アプリもメッセージング アプリも、メッセージが到着して削除されたことを示す通知を受信しません。
Peek	2	このアクションの種類のフィルターは、 ドロップ フィルターの後に適用されます。 このアクションの種類を使用すると、アプリケーションは各メッセージを検査し、削除されるメッセージと、ユーザーに対して処理または表示を続行するメッセージを決定できます。 注意 最大タイムアウト期間内に Drop または Accept を呼び出して、フィルター処理された各メッセージを処理する必要があります。 ピーク フィルターは、 SMS フィルター ルールによって提供される既存のフィルター メカニズムを使用して実行できない動的コード検査を必要とするスパム フィルターまたはウイルス スキャンで使用されることが期待されます。 このアクションの種類を使用すると、システム内の SMS メッセージ配信が遅くなる可能性があるため、アプリケーションはできるだけ早くメッセージを処理する必要があります。

例

(SMS 送受信)[https://github.com/Microsoft/Windows-universal-samples/tree/master/Samples/SmsSendAndReceive]