다음을 통해 공유


SmsReceivedEventDetails 클래스

정의

앱이 일시 중단되는 동안 메시지를 처리하는 백그라운드 작업 항목에 SMS 메시지 이벤트의 세부 정보를 표시합니다.

참고

이 기능은 모바일 네트워크 운영자, 모바일 광대역 어댑터 IHV 또는 OEM에서 권한 있는 액세스 권한이 부여된 통신사 앱 및 UWP 앱에서만 사용할 수 있습니다. 자세한 내용은 모바일 광대역을 참조하세요.

참고

이 클래스 및 해당 메서드는 이전 버전의 Windows에서 사용한 레거시 데스크톱 앱의 유지 관리를 위해 지원됩니다. 이 클래스를 사용하는 경우 앱 매니페스트에서 Windows.Devices.Sms.LegacySmsApiContract 를 지정해야 합니다. Windows용 새 앱을 개발하는 경우 이 클래스를 사용하지 마세요. 대신 Windows.Devices.Sms.LegacySmsApiContract가 필요하지 않은 이 네임스페이스의 API를 사용합니다.

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
상속
Object Platform::Object IInspectable SmsReceivedEventDetails
특성

Windows 요구 사항

디바이스 패밀리
Windows Desktop Extension SDK (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.Devices.Sms.LegacySmsApiContract (v1.0에서 도입되었습니다.)
앱 기능
cellularMessaging sms

설명

Windows는 포그라운드에 없는 애플리케이션을 일시 중단하여 배터리 수명을 연장합니다. 애플리케이션이 일시 중단된 동안에도 새 SMS 메시지를 처리해야 하는 경우 이를 처리하기 위해 백그라운드 작업 항목을 만들어야 합니다. 새 SMS 메시지가 도착하면 백그라운드 작업 항목이 활성화됩니다.

속성

BinaryMessage

백그라운드 작업에서 받은 SMS 메시지에 대한 이진 메시지 개체를 가져옵니다.

DeviceId

SMS 메시지를 받은 네트워크 인터페이스의 DeviceInformation ID를 반환합니다. 이 ID를 SmsDevice.FromIdAsync 에 전달하여 디바이스를 활성화하고 추가 메시지 세부 정보를 검색할 수 있습니다.

MessageClass

백그라운드 작업에서 받은 SMS 메시지에 대한 메시지 클래스를 가져옵니다.

MessageIndex

이벤트를 발생시킨 새 메시지의 인덱스 를 반환합니다. 이를 SmsDevice.GetMessageAsync에 전달하여 새 메시지 자체를 검색할 수 있습니다.

적용 대상