Share via


SmsReceivedEventDetails Clase

Definición

Presenta los detalles de los eventos de mensaje SMS al elemento de trabajo en segundo plano que controla los mensajes mientras la aplicación está suspendida.

Nota

Esta funcionalidad solo está disponible para aplicaciones de operadores móviles y aplicaciones para UWP con acceso con privilegios por parte de operadores de red móvil, IHV de adaptador de banda ancha móvil o OEM. Para obtener más información, consulte Banda ancha móvil.

Nota

Esta clase y sus métodos son compatibles con el mantenimiento de aplicaciones de escritorio heredadas que la usaron en versiones anteriores de Windows. Si usas esta clase, debes especificar Windows.Devices.Sms.LegacySmsApiContract en el manifiesto de la aplicación. No use esta clase si está desarrollando una nueva aplicación para Windows. En su lugar, use las API de este espacio de nombres que no requieran Windows.Devices.Sms.LegacySmsApiContract.

public ref class SmsReceivedEventDetails sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SmsReceivedEventDetails may be altered or unavailable for releases after Windows 10. Instead, use SmsMessageReceivedTriggerDetails.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class SmsReceivedEventDetails final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Deprecated("SmsReceivedEventDetails may be altered or unavailable for releases after Windows 10. Instead, use SmsMessageReceivedTriggerDetails.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
class SmsReceivedEventDetails final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SmsReceivedEventDetails may be altered or unavailable for releases after Windows 10. Instead, use SmsMessageReceivedTriggerDetails.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class SmsReceivedEventDetails
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Deprecated("SmsReceivedEventDetails may be altered or unavailable for releases after Windows 10. Instead, use SmsMessageReceivedTriggerDetails.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
public sealed class SmsReceivedEventDetails
Public NotInheritable Class SmsReceivedEventDetails
Herencia
Object Platform::Object IInspectable SmsReceivedEventDetails
Atributos

Requisitos de Windows

Familia de dispositivos
Windows Desktop Extension SDK (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Devices.Sms.LegacySmsApiContract (se introdujo en la versión v1.0)
Características de aplicaciones
cellularMessaging sms

Comentarios

Windows extiende la duración de la batería suspendiendo las aplicaciones que no están en primer plano. Si la aplicación necesita controlar nuevos mensajes SMS incluso mientras se suspende, debe crear un elemento de trabajo en segundo plano para controlarlo. Cuando llega un nuevo mensaje SMS, se activa el elemento de trabajo en segundo plano.

Propiedades

BinaryMessage

Obtiene el objeto de mensaje binario para el mensaje SMS recibido por la tarea en segundo plano.

DeviceId

Devuelve el identificador DeviceInformation de la interfaz de red que recibió el mensaje SMS. Este identificador se puede pasar a SmsDevice.FromIdAsync para activar el dispositivo y recuperar detalles adicionales del mensaje.

MessageClass

Obtiene la clase de mensaje para el mensaje SMS recibido por la tarea en segundo plano.

MessageIndex

Devuelve el índice del nuevo mensaje que generó el evento. Puede pasar esto a SmsDevice.GetMessageAsync para recuperar el nuevo mensaje.

Se aplica a