ISmsDevice インターフェイス

定義

このインターフェイスは、モバイル ブロードバンド SMS デバイスを制御します。 これは、デバイス上の SMS サービスへのプライマリ エントリ ポイントです。

Note

この機能は、モバイル ネットワーク オペレーター、モバイル ブロードバンド アダプター IHV、または OEM による特権アクセスが与えられた、モバイル オペレーター アプリと UWP アプリでのみ使用できます。 詳細については、「 モバイル ブロードバンド」を参照してください。

public interface class ISmsDevice
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
struct ISmsDevice
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
/// [Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
struct ISmsDevice
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
public interface ISmsDevice
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
[Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
public interface ISmsDevice
Public Interface ISmsDevice
派生
属性

Windows の要件

デバイス ファミリ
Windows Desktop Extension SDK (10.0.10240.0 で導入)
API contract
Windows.Devices.Sms.LegacySmsApiContract (v1.0 で導入)
アプリの機能
cellularMessaging sms

プロパティ

AccountPhoneNumber

SMS デバイスに関連付けられている電話番号を返します。 電話番号を使用して、受信メッセージをアカウントに関連付けることができ、場合によっては、アカウントの受信トレイなどの外部ストレージ メカニズムを関連付けることができます。

CellularClass

SMS デバイスの携帯ネットワーク クラスを返します。 クラスを使用して、適切なエンコードまたは有効なデバイス制限を決定できます。

DeviceStatus

SMS デバイスの状態を返します。これは、デバイスの準備ができているかどうかを示します。 また、デバイスの準備ができていない場合に、どのような種類の問題が存在するかも説明します。

MessageStore

デバイス上のメッセージ ストアにアクセスします。 ストアは、クライアントがメッセージを取得できるようになるまでメッセージを保持します。 たとえば、一部のデバイスでは、ストアが SMS メッセージの SIM ストレージに対応している場合があります。

メソッド

CalculateLength(SmsTextMessage)

指定したテキスト メッセージの送信メッセージ長を見積もります。 この見積もりは、ネットワーク上で送信されるメッセージの数を示して、メッセージ全体のテキストを伝達する必要があるクライアントに役立ちます。

SendMessageAsync(ISmsMessage)

SMS デバイスを使用してメッセージを非同期に送信します。 送信操作が瞬時に実行されない可能性があるため、メソッドは非同期です。 非同期操作オブジェクトはすぐに返されます。

イベント

SmsDeviceStatusChanged

SMS デバイスの状態が変更されたときに呼び出されるイベント ハンドラーを設定します。

SmsMessageReceived

デバイスが新しいテキスト メッセージを受信したときに呼び出されるイベント ハンドラーを設定します。

適用対象