다음을 통해 공유


ISmsDevice 인터페이스

정의

이 인터페이스는 모바일 광대역 SMS 디바이스를 제어합니다. 디바이스의 SMS 서비스에 대한 기본 진입점입니다.

참고

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

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
파생
특성

Windows 요구 사항

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

속성

AccountPhoneNumber

SMS 디바이스와 연결된 전화 번호를 반환합니다. 전화 번호를 사용하여 들어오는 메시지를 계정 및 계정 받은 편지함과 같은 외부 스토리지 메커니즘과 연결할 수 있습니다.

CellularClass

SMS 디바이스의 셀룰러 클래스를 반환합니다. 클래스를 사용하여 적절한 인코딩 또는 적용되는 디바이스 제한을 확인할 수 있습니다.

DeviceStatus

디바이스가 준비되었는지 여부를 나타내는 SMS 디바이스의 상태 반환합니다. 또한 디바이스가 준비되지 않은 경우 존재하는 문제 유형을 지정합니다.

MessageStore

디바이스 내 메시지 저장소에 액세스합니다. 저장소는 클라이언트가 메시지를 검색할 수 있게 될 때까지 메시지를 보관합니다. 예를 들어 일부 디바이스에서 저장소는 SMS 메시지의 SIM 스토리지에 해당할 수 있습니다.

메서드

CalculateLength(SmsTextMessage)

지정된 문자 메시지의 전송된 메시지 길이를 예측합니다. 예상은 전체 메시지의 텍스트를 전달하기 위해 네트워크에서 전송되는 메시지 수를 표시하려는 클라이언트에 유용할 수 있습니다.

SendMessageAsync(ISmsMessage)

SMS 디바이스를 사용하여 메시지를 비동기적으로 보냅니다. 전송 작업이 즉시 발생하지 않을 수 있으므로 메서드는 비동기적입니다. 비동기 작업 개체가 즉시 반환됩니다.

이벤트

SmsDeviceStatusChanged

SMS 디바이스의 상태 변경될 때 호출할 이벤트 처리기를 설정합니다.

SmsMessageReceived

디바이스에서 새 문자 메시지를 받을 때 호출할 이벤트 처리기를 설정합니다.

적용 대상