Метод IMbnSms::GetSmsStatus (mbnapi.h)
Важно!
Начиная с Windows 10 версии 1803, API Win32, описанные в этом разделе, заменяются среда выполнения Windows API в пространстве имен Windows.Networking.Connectivity.
Возвращает состояние SMS для устройства.
Синтаксис
HRESULT GetSmsStatus(
[out] MBN_SMS_STATUS_INFO *smsStatusInfo
);
Параметры
[out] smsStatusInfo
Указатель на структуру MBN_SMS_STATUS_INFO , содержащую сведения о состоянии устройства.
Возвращаемое значение
Этот метод может возвращать одно из этих значений.
| Код возврата | Описание |
|---|---|
|
Метод завершился успешно. |
|
Состояние SMS недоступно. Служба мобильной широкополосной связи проверит устройство на наличие информации. Вызывающее приложение может получать уведомления о доступности состояния SMS, зарегистрировав метод OnSmsStatusChange интерфейса IMbnSmsEvents . |
|
Для получения этих сведений требуется ПИН-код. |
|
SIM-карта не вставляется в устройство. |
|
В устройство вставляется неправильная SIM-карта. |
Комментарии
При возникновении таких ошибок, как E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED и E_MBN_BAD_SIM, служба мобильной широкополосной связи повторно запрашивает эти сведения у устройства после завершения состояния ошибки. Например, если устройству требуется ввести ПИН-код для получения этих сведений, оно вернет E_MBN_PIN_REQUIRED. Когда приложение вводит ПИН-код для разблокировки устройства, служба мобильной широкополосной связи снова попытается получить эти сведения с устройства. Служба мобильной широкополосной связи вызовет метод OnSmsStatusChange интерфейса IMbnSmsEvents .
Состояние хранилища SMS-сообщений может измениться из-за нового сообщения, полученного системой. При любом изменении состояния хранилища сообщений служба мобильной широкополосной связи вызывает метод OnSmsStatusChange интерфейса IMbnSmsEvent .
Операции, выданные приложением, такие как чтение или удаление сообщений, могут сбрасывать флаг в MBN_SMS_STATUS_INFO структуре. Изменение в хранилище SMS, вызванное этим сбросом, не приведет к вызову какого-либо метода уведомления.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | mbnapi.h |