SmsReceivedEventDetails Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
- 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. |