Поделиться через

Метод IMbnSms::GetSmsConfiguration (mbnapi.h)

  • Статья

Важно!

Начиная с Windows 10 версии 1803 API Win32, описанные в этом разделе, заменяются API среда выполнения Windows в пространстве имен Windows.Networking.Connectivity.

Возвращает конфигурацию SMS устройства.

Синтаксис

HRESULT GetSmsConfiguration(
  [out, retval] IMbnSmsConfiguration **smsConfiguration
);

Параметры

[out, retval] smsConfiguration

Интерфейс IMbnSmsConfiguration , представляющий конфигурацию SMS устройства.

Возвращаемое значение

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Метод завершился успешно.
E_PENDING
 Конфигурация SMS недоступна. Служба мобильной широкополосной связи проверит устройство на наличие информации. Вызывающее приложение может получать уведомления о доступности конфигурации SMS, зарегистрировав метод OnSmsConfigurationChange интерфейса IMbnSmsEvents .
E_MBN_PIN_REQUIRED
 Для получения этих сведений требуется ПИН-код.
E_MBN_SIM_NOT_INSERTED
 На устройстве нет SIM-карты.
E_MBN_BAD_SIM
 На устройстве есть неправильная SIM-карта.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 SMS не поддерживается устройством.

Комментарии

При возникновении таких ошибок с возможностью восстановления, как E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED и E_MBN_BAD_SIM, служба мобильной широкополосной связи снова запрашивает эти сведения у устройства после завершения состояния ошибки. Например, если устройство требует ввода ПИН-кода для получения этих сведений, оно вернет E_MBN_PIN_REQUIRED. Когда приложение вводит ПИН-код для разблокировки устройства, служба мобильной широкополосной связи снова попытается получить эти сведения с устройства. Служба мобильной широкополосной связи вызовет метод OnSmsConfigurationChange интерфейса IMbnSmsEvents .

Конфигурация SMS может быть обновлена сетью или устройством без запроса на изменение от любого приложения. В этом случае служба мобильной широкополосной связи уведомляет все зарегистрированные приложения, вызывая метод OnSmsConfigurationChange интерфейса IMbnSmsEvents .

Требования

   
Минимальная версия клиента Windows 7 [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header mbnapi.h

См. также раздел

IMbnSms