Метод IMbnSmsEvents::OnSmsReadComplete (mbnapi.h)

Важно!

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

Метод уведомления, указывающий на завершение операции чтения сообщения.

Синтаксис

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Параметры

[in] sms

Интерфейс IMbnSms , представляющий хранилище сообщений, которое завершило операцию.

[in] smsFormat

Значение MBN_SMS_FORMAT , определяющее формат SMS-сообщения.

[in] readMsgs

Массив сообщений, считываемых с устройства.

[in] moreMsgs

Логическое значение, указывающее, обрабатывается ли еще больше сообщений. Если задано значение TRUE, onSmsReadComplete будет вызываться повторно, пока не будет больше сообщений и moreMsgs не будет иметь значение FALSE.

[in] requestID

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

[in] status

Код состояния, указывающий результат операции.

Вызывающее приложение может ожидать одно из следующих значений.

Значение	Значение
S_OK	Операция выполнена успешно.
E_MBN_SIM_NOT_INSERTED	На устройстве нет SIM-карты.
E_MBN_BAD_SIM	На устройстве есть неправильная SIM-карта.
E_MBN_PIN_REQUIRED	Для завершения операции требуется ПИН-код.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Ни операция SMS, ни конкретный формат SMS не поддерживаются устройством.
E_MBN_SMS_MEMORY_FAILURE	Сбой памяти SMS.
E_MBN_SMS_INVALID_MEMORY_INDEX	Индекс памяти с запрошенным значением отсутствует.
E_MBN_SMS_FILTER_NOT_SUPPORTED	Устройство не поддерживает запрошенный фильтр.

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

Этот метод должен возвращать S_OK.

Комментарии

Для устройств GSM вызывающее приложение должно вызывать QueryInterface для каждого элемента в readMsgs для интерфейса IMbnSmsReadMsgPdu .

Если для устройств CDMA MBN_SMS_FORMAT_TEXTsmsFormat, приложение должно вызывать QueryInterface для интерфейса IMbnSmsReadMsMsgTextCdma; В противном случае, если smsFormatMBN_SMS_FORMAT_PDU, приложение должно вызвать QueryInterface для интерфейса IMbnSmsReadMsMsgPdu.

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

Требования

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

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

События IMbnSmsEvents