ISmsTextMessage Schnittstelle

Definition

Namespace:

Windows.Devices.Sms

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.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.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

Windows.Devices.Sms.SmsTextMessage

Attribute

ContractVersionAttribute DeprecatedAttribute GuidAttribute

Implementiert

ISmsMessage

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.

Weitere Informationen

• ISmsMessage