Windows.Devices.Sms 命名空間

提供傳送和接收簡訊服務的功能， (SMS) 訊息、篩選傳入訊息，以及以無訊息方式傳送訊息，以及查詢行動寬頻 SMS 裝置的相關屬性。 使用此 API 來實作行動電信業者 (MO) 應用程式，這些應用程式會使用應用程式導向 SMS 來實作 MO 功能，例如視覺語音信箱應用程式。

如果您要開發內建傳訊應用程式的替代方案，這不是建議的 API。 相反地，您應該使用 Windows.AppModel.Chat API 來開發傳訊應用程式。 聊天 API 會維護訊息的通用資料存放區，讓所有使用聊天 API 的應用程式都會顯示一致的訊息檢視。 Windows.Devices.Sms 不提供這類資料存放區，事實上使用它可能會干擾將 SMS 訊息傳遞至使用聊天 API 的應用程式。

請注意，這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 授與特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。

請注意，此命名空間中的數個類別僅支援維護舊版 Windows 中使用的舊版傳統型應用程式;而且，如果您使用舊版支援類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于Windows 10的新應用程式，請勿使用舊版支援類別。 請改用不需要 Windows.Devices.Sms.LegacySmsApiContract之命名空間的成員。

類別

DeleteSmsMessageOperation	啟用單一訊息的啟動、追蹤和結束非同步訊息刪除作業。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
DeleteSmsMessagesOperation	啟用多個訊息的啟動、追蹤和結束非同步 SMS 訊息刪除作業。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
GetSmsDeviceOperation	以非同步方式擷取 SmsDevice 物件。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
GetSmsMessageOperation	支援從 SMS 訊息存放區擷取訊息。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
GetSmsMessagesOperation	支援擷取訊息。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SendSmsMessageOperation	啟用訊息的傳送。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。 注意 在舊版 Windows 中使用舊版傳統型應用程式的維護時，支援這個類別及其方法。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsAppMessage	用於操作 SMS 應用程式訊息的介面。 應用程式訊息是無法描述為任何其他訊息類型的訊息。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsBinaryMessage	表示原始 PDU 格式的 SMS 訊息。 資料格式會因訊息格式 (格式 (格式) 為 GSM 或 CDMA 的值而有所不同。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。 注意 在舊版 Windows 中使用舊版傳統型應用程式的維護時，支援這個類別及其方法。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsBroadcastMessage	表示廣播 SMS 訊息。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsDevice	支援行動寬頻 SMS 裝置的作業。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。 注意 在舊版 Windows 中使用舊版傳統型應用程式的維護時，支援這個類別及其方法。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsDevice2	擴充 SmsDevice 類別，並支援行動寬頻 SMS 裝置的作業。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsDeviceMessageStore	提供 SMS 裝置上所儲存訊息的存取權，以及訊息存放區的相關資訊。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。 注意 在舊版 Windows 中使用舊版傳統型應用程式的維護時，支援這個類別及其方法。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsFilterRule	描述 SMS 篩選規則。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsFilterRules	SmsFilterRule實例的集合。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsMessageReceivedEventArgs	提供 ISmsBinaryMessage 事件處理常式的資料。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsMessageReceivedTriggerDetails	包含收到 SMS 訊息時所引發事件的事件詳細資料。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
SmsMessageRegistration	用來表示已註冊訊息篩選準則的類別。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
SmsReceivedEventDetails	將 SMS 訊息事件的詳細資料呈現至在應用程式暫停時處理訊息的背景工作專案。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsSendMessageResult	封裝呼叫 SmsDevice2.SendMessageAndGetResultAsync的結果。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
SmsStatusMessage	封裝 SMS 狀態訊息。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 若要存取已接收的狀態訊息，請建立 SmsMessageReceived 事件所觸發的背景工作。 在該工作中，請先使用 SmsMessageReceivedTriggerDetails.MessageType 來判斷訊息是狀態訊息，然後使用 SmsMessageReceivedTriggerDetails.StatusMessage 屬性來存取此類別的實例。
SmsTextMessage	管理解碼的簡訊簡訊，提供訊息純文字本文的直接存取權，以及金鑰標頭屬性，例如時間戳記。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsTextMessage2	封裝解碼的 SMS 簡訊。 偏好此類別為較舊的 SmsTextMessage 類別。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 若要傳送文字訊息，請建構此類別的實例、設定所有適當的欄位，並使用 SmsDevice2.SendMessageAndGetResultAsync 傳送。 若要存取收到的簡訊，請建立 SmsMessageReceived 事件所觸發的背景工作。 在該工作中，請先使用 SmsMessageReceivedTriggerDetails.MessageType 來判斷訊息是文字訊息，然後使用 SmsMessageReceivedTriggerDetails.TextMessage 屬性來存取這個類別的實例。
SmsVoicemailMessage	封裝 SMS 語音信箱訊息。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
SmsWapMessage	表示 SMS WAP 推播訊息。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。

結構

SmsEncodedLength

此結構代表 當 SmsTextMessage 物件編碼為 PDU 時，其長度的相關資訊。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。

介面

ISmsBinaryMessage	此介面可讓您存取 SMS 訊息的原始二進位格式。 訊息會儲存在業界標準通訊協定描述單位 (PDU) 格式， (請參閱 SMS 規格 GSM 03.40) 。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
ISmsDevice	此介面可控制行動寬頻 SMS 裝置。 這是裝置上 SMS 服務的主要進入點。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
ISmsMessage	此介面是由支援的所有 SMS 訊息類型所實作。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
ISmsMessageBase	此介面會指定所有 SMS 訊息類型的基底功能。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
ISmsTextMessage	此介面會操作解碼的 SMS 簡訊。 它可讓您直接存取訊息的純文字本文，以及索引鍵標頭屬性，例如時間戳記。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。

列舉

CellularClass	這個列舉型別會定義裝置中的無線電標準類型。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
SmsBroadcastType	描述廣播 (緊急警示) 訊息類型的值。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsDataFormat	這個列舉類型會識別指定的通訊協定描述單位格式， (PDU) 緩衝區。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsDeviceStatus	包含值，指出 SMS 裝置的整備程度，以參與行動資料網路流量作業。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsEncoding	這個列舉型別可用來判斷編碼演算法，以傳送或計算 SmsTextMessage 物件的長度。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsFilterActionType	值，描述在訊息篩選上要採取的動作。 當傳訊應用程式使用 SMS 來傳達不一定要向使用者顯示的應用程式特定資料時，傳訊應用程式會使用 SMS 篩選器。 請注意，篩選準則會依固定順序依篩選動作類型進行處理。 系統會先處理所有 AcceptImmediately 篩選準則，然後再處理所有 Drop 篩選準則等等。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsGeographicalScope	描述資料格廣播訊息地理範圍的值。
SmsMessageClass	這個列舉型別會指定訊息的訊息類別。 訊息類別通常源自于網路，而不是行動裝置。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsMessageFilter	這個列舉類型會指定裝置訊息存放區中執行作業的訊息。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。
SmsMessageType	這個列舉型別會定義 SMS 訊息的格式。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。
SmsModemErrorCode	描述 SmsSendMessageResult中 SMS 數據機錯誤碼的值。

委派

SmsDeviceStatusChangedEventHandler	當 SMS 裝置的狀態變更時，會呼叫此處理程式。 當呼叫端想要在裝置上發生重大狀態變更時收到通知時，應該實作此動作。 例如，呼叫端可能想要知道裝置何時準備好傳送和接收訊息。 注意 這項功能僅適用于行動電信業者、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取的電信業者和 UWP 應用程式。 如需詳細資訊，請參閱 行動寬頻。
SmsMessageReceivedEventHandler	收到新的二進位訊息時，會呼叫這個事件處理常式。 當呼叫端想要處理來自指定 SMS 裝置的新二進位訊息時，應實作此動作。 注意 這項功能僅適用于行動電信業者應用程式和 UWP 應用程式，由行動網路操作員、行動寬頻介面卡 IHV 或 OEM 提供特殊許可權存取。 如需詳細資訊，請參閱 行動寬頻。 注意 此類別及其方法支援維護舊版 Windows 中使用的舊版傳統型應用程式。 如果您使用這個類別，則必須在應用程式的資訊清單中指定 Windows.Devices.Sms.LegacySmsApiContract 。 如果您要開發適用于 Windows 的新應用程式，請勿使用此類別。 請改用此命名空間中不需要 Windows.Devices.Sms.LegacySmsApiContract的 API。

備註

若要在收到 SMS 時收到背景工作通知，請處理 Windows.ApplicationModel.Background.SmsMessageReceivedTrigger。

另請參閱

• 應用程式功能宣告
• SMS 傳送和接收範例
• SMS 傳送和接收範例 (Windows 10)