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

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

  • Статья

Важно!

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

Считывает набор SMS-сообщений с устройства.

Синтаксис

HRESULT SmsRead(
  [in]  MBN_SMS_FILTER *smsFilter,
  [in]  MBN_SMS_FORMAT smsFormat,
  [out] ULONG          *requestID
);

Параметры

[in] smsFilter

Указатель на структуру MBN_SMS_FILTER , которая определяет набор считываемых сообщений.

[in] smsFormat

Значение MBN_SMS_FORMAT , указывающее формат, в котором должно быть прочитано SMS-сообщение.

Для устройств GSM она всегда должна быть MBN_SMS_FORMAT_PDU.

Если для устройств CDMA указано MBN_SMS_FORMAT_PDU, устройство считывает сообщение CDMA в двоичном режиме. Если он указан как MBN_SMS_FORMAT_TEXT, устройство будет считывать текстовое сообщение CDMA. Если устройство не поддерживает указанный формат, оно может вернуть код ошибки.

[out] requestID

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

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Служба мобильного широкополосного подключения не работает в этой системе.
E_HANDLE
 Недопустимый интерфейс, скорее всего, потому, что устройство было удалено из системы.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Недопустимый интерфейс. Скорее всего, мобильное широкополосное устройство было удалено из системы.
E_INVALIDARG
 Недопустимый формат smsFormat или smsFilter .

Комментарии

С помощью smsFilter приложение может задавать базовые фильтры, такие как новые сообщения, черновики сообщений или определенное сообщение с помощью индекса. Сложный фильтр можно использовать путем интеграции сочетания базовых фильтров. Все интерфейсы поддерживают фильтры на основе индекса и новые фильтры типов сообщений. Поддержка других фильтров для некоторых интерфейсов необязательна. Если указанный фильтр не поддерживается, функция обратного вызова завершения операции возвращает состояние E_MBN_STATUS_FILTER_NOT_SUPPORTED.

Это асинхронная операция, которая возвращается немедленно. Если метод возвращает без ошибок, служба мобильного широкополосного подключения вызовет метод OnSmsReadComplete интерфейса IMbnSmsEvents .

Требования

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

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

IMbnSms