IMbnSms：：GetSmsStatus 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得裝置的 SMS 狀態。
語法
HRESULT GetSmsStatus(
[out] MBN_SMS_STATUS_INFO *smsStatusInfo
);
參數
[out] smsStatusInfo
MBN_SMS_STATUS_INFO結構的指標，其中包含裝置的狀態資訊。
傳回值
這個方法可以傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 |
|
無法使用 SMS 狀態。 行動寬頻服務正在探查裝置以取得資訊。 藉由註冊IMbnSmsEvents介面的OnSmsStatusChange方法，即可在 SMS 狀態可供使用時通知呼叫應用程式。 |
|
需要 PIN 才能取得此資訊。 |
|
不會在裝置中插入 SIM 卡。 |
|
在裝置中插入錯誤的 SIM 卡。 |
備註
針對可復原的錯誤，例如 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM，行動寬頻服務會在錯誤狀況超過時重新查詢裝置以取得這項資訊。 例如，如果裝置需要輸入 PIN 才能擷取這項資訊，則會傳回 E_MBN_PIN_REQUIRED。 當應用程式輸入 PIN 以解除鎖定裝置時，行動寬頻服務會再次嘗試從裝置取得此資訊。 行動寬頻服務會呼叫IMbnSmsEvents介面的OnSmsStatusChange方法
SMS 訊息存放區狀態可能會因為系統收到的新訊息而變更。 在訊息存放區狀態的任何變更上，行動寬頻服務會呼叫IMbnSmsEvent介面的OnSmsStatusChange方法。
應用程式發出的作業，例如讀取或刪除訊息，可能會在MBN_SMS_STATUS_INFO結構中重設旗標。 此重設所造成的 SMS 存放區變更，將不會產生任何通知方法的呼叫。
需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |