ISmsDevice Schnittstelle

Definition

Namespace:

Windows.Devices.Sms

Diese Schnittstelle steuert ein mobiles Breitband-SMS-Gerät. Es ist der primäre Einstiegspunkt für SMS-Dienste auf dem Gerät.

Hinweis

Diese Funktionalität steht nur für Apps von Mobilfunkanbietern und UWP-Apps mit privilegiertem Zugriff durch Mobilfunknetzbetreiber, mobile Breitbandadapter IHV oder OEM zur Verfügung. Weitere Informationen finden Sie unter Mobiles Breitband.

public interface class 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.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

Abgeleitet

Windows.Devices.Sms.SmsDevice

Attribute

ContractVersionAttribute DeprecatedAttribute GuidAttribute

Windows-Anforderungen

Gerätefamilie	Windows Desktop Extension SDK (eingeführt in 10.0.10240.0)
API contract	Windows.Devices.Sms.LegacySmsApiContract (eingeführt in v1.0)
App-Funktionen	cellularMessaging sms

Eigenschaften

AccountPhoneNumber	Gibt die Telefonnummer zurück, die dem SMS-Gerät zugeordnet ist. Die Telefonnummer kann verwendet werden, um eingehende Nachrichten dem Konto und möglicherweise einem externen Speichermechanismus wie einem Kontoeingang zuzuordnen.
CellularClass	Gibt die Mobilfunkklasse des SMS-Geräts zurück. Die -Klasse kann verwendet werden, um zu bestimmen, welche Codierungen geeignet sind oder welche Geräteeinschränkungen gelten.
DeviceStatus	Gibt den status des SMS-Geräts zurück, der angibt, ob das Gerät bereit ist. Es gibt auch an, welche Art von Problem vorliegt, wenn das Gerät nicht bereit ist.
MessageStore	Greift auf den Nachrichtenspeicher auf dem Gerät zu. Der Speicher enthält Nachrichten, bis ein Client sie abrufen kann. Auf einigen Geräten kann der Speicher beispielsweise dem SIM-Speicher für SMS-Nachrichten entsprechen.

Methoden

CalculateLength(SmsTextMessage)	Schätzt die Länge der übertragenen Nachricht der angegebenen Textnachricht. Die Schätzung kann für Clients nützlich sein, die einen Hinweis darauf geben möchten, wie viele Nachrichten im Netzwerk gesendet werden, um den Text der vollständigen Nachricht zu enthalten.
SendMessageAsync(ISmsMessage)	Sendet asynchron eine Nachricht über das SMS-Gerät. Die -Methode ist asynchron, da der Sendevorgang möglicherweise nicht sofort erfolgt. Das asynchrone Vorgangsobjekt wird sofort zurückgegeben.

Ereignisse

SmsDeviceStatusChanged	Legt einen Ereignishandler fest, der aufgerufen werden soll, wenn sich die status des SMS-Geräts ändert.
SmsMessageReceived	Legt einen Ereignishandler fest, der aufgerufen werden soll, wenn das Gerät eine neue SMS empfängt.