IMbnSms：：GetSmsConfiguration 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得裝置的 SMS 組態。
語法
HRESULT GetSmsConfiguration(
[out, retval] IMbnSmsConfiguration **smsConfiguration
);
參數
[out, retval] smsConfiguration
代表裝置 SMS 設定的 IMbnSmsConfiguration 介面。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
無法使用 SMS 組態。 行動寬頻服務正在探查裝置以取得資訊。 註冊IMbnSmsEvents介面的OnSmsConfigurationChange方法，即可通知呼叫應用程式。 |
|
需要 PIN 才能取得此資訊。 |
|
裝置中沒有 SIM 卡。 |
|
裝置中有不正確的 SIM 卡。 |
|
裝置不支援 SMS。 |
備註
針對可復原的錯誤，例如 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM，行動寬頻服務會在錯誤狀況超過時重新查詢裝置以取得這項資訊。 例如，如果裝置需要輸入 PIN 才能擷取這項資訊，則會傳回 E_MBN_PIN_REQUIRED。 當應用程式輸入 PIN 以解除鎖定裝置時，行動寬頻服務會再次嘗試從裝置取得此資訊。 行動寬頻服務會呼叫IMbnSmsEvents介面的OnSmsConfigurationChange方法
網路或裝置可以更新 SMS 組態，而不需要任何應用程式的任何變更要求。 在這種情況下，行動寬頻服務會呼叫IMbnSmsEvents介面的OnSmsConfigurationChange方法，以通知所有已註冊的應用程式。
需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |