Partilhar via


ISmsDevice Interface

Definição

Essa interface controla um dispositivo de SMS de banda larga móvel. É o ponto de entrada principal para serviços de SMS no dispositivo.

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.

public interface class ISmsDevice
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, Windows.Devices.Sms.LegacySmsApiContract)]
/// [Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
struct ISmsDevice
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Devices.Sms.LegacySmsApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
/// [Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
struct ISmsDevice
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, typeof(Windows.Devices.Sms.LegacySmsApiContract))]
[Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
public interface ISmsDevice
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Devices.Sms.LegacySmsApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(152539629, 34603, 20204, 156, 114, 171, 17, 98, 123, 52, 236)]
[Windows.Foundation.Metadata.Deprecated("SmsDevice may be altered or unavailable for releases after Windows 10. Instead, use SmsDevice2.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 65536, "Windows.Devices.Sms.LegacySmsApiContract")]
public interface ISmsDevice
Public Interface ISmsDevice
Derivado
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

Propriedades

AccountPhoneNumber

Retorna o número de telefone associado ao dispositivo SMS. O número de telefone pode ser usado para associar mensagens de entrada à conta e, possivelmente, a um mecanismo de armazenamento externo, como uma caixa de entrada de conta.

CellularClass

Retorna a classe celular do dispositivo SMS. A classe pode ser usada para determinar quais codificações são apropriadas ou quais limitações de dispositivo estão em vigor.

DeviceStatus

Retorna o status do dispositivo SMS, que indica se o dispositivo está pronto ou não. Ele também indca qual tipo de problema existe se o dispositivo não estiver pronto.

MessageStore

Acessa o repositório de mensagens no dispositivo. O repositório mantém mensagens até que um cliente possa recuperá-las. Em alguns dispositivos, por exemplo, o repositório pode corresponder ao armazenamento do SIM para mensagens SMS.

Métodos

CalculateLength(SmsTextMessage)

Estima o comprimento da mensagem transmitida da mensagem de texto especificada. A estimativa pode ser útil para clientes que desejam dar uma indicação de quantas mensagens serão enviadas na rede para carregar o texto da mensagem completa.

SendMessageAsync(ISmsMessage)

Envia uma mensagem de forma assíncrona usando o dispositivo SMS. O método é assíncrono porque a operação de envio pode não ocorrer instantaneamente. O objeto de operação assíncrona é retornado imediatamente.

Eventos

SmsDeviceStatusChanged

Define um manipulador de eventos a ser chamado quando o status do dispositivo SMS for alterado.

SmsMessageReceived

Define um manipulador de eventos a ser chamado quando o dispositivo recebe uma nova mensagem de texto.

Aplica-se a