Share via


SmsReceivedEventDetails Classe

Definição

Apresenta os detalhes dos eventos de mensagem SMS para o item de trabalho em segundo plano que manipula mensagens enquanto seu aplicativo está suspenso.

Observação

Essa funcionalidade está disponível apenas para aplicativos de operadora móvel e aplicativos UWP com acesso privilegiado por operadoras de rede móvel, IHV de adaptador de banda larga móvel ou OEM. Para obter mais informações, consulte Banda Larga Móvel.

Observação

Essa classe e seus métodos têm suporte para a manutenção de aplicativos de área de trabalho herdados que a usavam em versões anteriores do Windows. Se você usar essa classe, deverá especificar o Windows.Devices.Sms.LegacySmsApiContract no manifesto do aplicativo. Não use essa classe se você estiver desenvolvendo um novo aplicativo para Windows. Em vez disso, use as APIs nesse namespace que não exigem o 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
Herança
Object Platform::Object IInspectable SmsReceivedEventDetails
Atributos

Requisitos do Windows

Família de dispositivos
Windows Desktop Extension SDK (introduzida na 10.0.10240.0)
API contract
Windows.Devices.Sms.LegacySmsApiContract (introduzida na v1.0)
Funcionalidades do aplicativo
cellularMessaging sms

Comentários

O Windows estende a duração da bateria suspendendo aplicativos que não estão em primeiro plano. Se o aplicativo precisar lidar com novas mensagens SMS mesmo quando estiver suspenso, ele precisará criar um item de trabalho em segundo plano para lidar com isso. Quando uma nova mensagem SMS chega, o item de trabalho em segundo plano é ativado.

Propriedades

BinaryMessage

Obtém o objeto de mensagem binária para a mensagem SMS recebida pela tarefa em segundo plano.

DeviceId

Retorna a ID DeviceInformation do adaptador de rede que recebeu a mensagem SMS. Essa ID pode ser passada para SmsDevice.FromIdAsync para ativar o dispositivo e recuperar detalhes adicionais da mensagem.

MessageClass

Obtém a classe de mensagem para a mensagem SMS recebida pela tarefa em segundo plano.

MessageIndex

Retorna o índice da nova mensagem que gerou o evento. Você pode passar isso para SmsDevice.GetMessageAsync para recuperar a nova mensagem em si.

Aplica-se a