Freigeben über


ISmsTextMessage Schnittstelle

Definition

Diese Schnittstelle bearbeitet eine decodierte SMS-Textnachricht. Es bietet direkten Zugriff auf den Nur-Text-Text der Nachricht sowie auf Schlüsselheadereigenschaften, z. B. Zeitstempel.

Hinweis

Diese Funktionalität ist nur für Apps von Mobilfunkanbietern und UWP-Apps verfügbar, die privilegierten Zugriff von Mobilfunknetzbetreibern, mobilem Breitbandadapter IHV oder OEM erhalten. Weitere Informationen finden Sie unter Mobile Breitband.

Hinweis

Diese Klasse und ihre Methoden werden für die Wartung von Legacy-Desktop-Apps unterstützt, die sie in früheren Versionen von Windows verwendet haben. Wenn Sie diese Klasse verwenden, müssen Sie windows.Devices.Sms.LegacySmsApiContract im Manifest Ihrer App angeben. Verwenden Sie diese Klasse nicht, wenn Sie eine neue App für Windows entwickeln. Verwenden Sie stattdessen die APIs in diesem Namespace, für die windows.Devices.Sms.LegacySmsApiContract nicht erforderlich ist.

public interface class ISmsTextMessage : ISmsMessage
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.Guid(3592196172, 42133, 18559, 154, 111, 151, 21, 72, 197, 188, 159)]
struct ISmsTextMessage : ISmsMessage
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(3592196172, 42133, 18559, 154, 111, 151, 21, 72, 197, 188, 159)]
/// [Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
struct ISmsTextMessage : ISmsMessage
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.Guid(3592196172, 42133, 18559, 154, 111, 151, 21, 72, 197, 188, 159)]
public interface ISmsTextMessage : ISmsMessage
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(3592196172, 42133, 18559, 154, 111, 151, 21, 72, 197, 188, 159)]
[Windows.Foundation.Metadata.Deprecated("SmsTextMessage may be altered or unavailable for releases after Windows 10. Instead, use SmsTextMessage2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
public interface ISmsTextMessage : ISmsMessage
Public Interface ISmsTextMessage
Implements ISmsMessage
Abgeleitet
Attribute
Implementiert

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

Hinweise

Schnittstellenvererbung

ISmsTextMessage erbt ISmsMessage. Typen, die ISmsTextMessage implementieren, implementieren auch die Schnittstellenmember von ISmsMessage.

Eigenschaften

Body

Gibt den Nur-Text-Text der Nachricht an.

Encoding

Gibt den Codierungstyp an, der für die Verwendung beim Senden dieser Nachricht festgelegt wurde.

From

Gibt die Telefonnummer des Absenders der Nachricht an.

Id

Ruft eine ID für die Nachricht ab, die später in aufrufenden Nachrichtenspeichermethoden angegeben werden kann, um die Nachricht abzurufen oder zu löschen.

(Geerbt von ISmsMessage)
MessageClass

Gibt die Nachrichtenklasse zurück, die vom Nachrichtennetzwerk des Operators bestimmt wird. Die beiden am häufigsten verwendeten Klassen sind None (normale Nachricht) oder Class0 (spezielle Operatormeldung, z. B. eine Roamingwarnung, die dem Benutzer sofort angezeigt werden muss). Ein typischer Client für Endbenutzernachrichten ignoriert Class0-Nachrichten.

(Geerbt von ISmsMessage)
PartCount

Ruft die Gesamtzahl der Teile in der ursprünglichen Nachricht ab, wenn die Nachricht Teil einer mehrteiligen Nachricht ist.

PartNumber

Ruft die Teilenummer einer mehrteiligen Nachricht ab, wenn diese Nachricht Teil einer mehrteiligen Nachricht ist. Es kann verwendet werden, um die ursprüngliche Nachricht zu rekonstruieren, indem die Teile in Verbindung mit den Eigenschaften PartReferenceId und PartCount verknüpft werden.

PartReferenceId

Gibt einen Verweiswert an, der verwendet werden kann, wenn die Nachricht Teil einer mehrteiligen Nachricht ist. Wenn diese Nachricht zu einer mehrteiligen Nachricht gehört, kann der PartNumber-Wert verwendet werden, um die vollständige ursprüngliche Nachricht zu rekonstruieren, und jeder Teil dieser Nachricht hat den gleichen Wert für PartReferenceId.

Timestamp

Ruft den Zeitstempel der Nachricht ab. Er wird lokal für eine erstellte Nachricht instance oder aus dem Service Center-Zeitstempel einer empfangenen Nachricht bestimmt.

To

Gibt die Telefonnummer des Empfängers dieser Nachricht an.

Methoden

ToBinaryMessages(SmsDataFormat)

Liest eine Nachricht im angegebenen Format und platziert die Ergebnisse in einer neuen instance einer binären Nachricht.

Gilt für:

Weitere Informationen