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

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

  • Статья

Важно!

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

Отправляет сообщение в формате PDU.

Синтаксис

HRESULT SmsSendPdu(
  [in]  LPCWSTR pduData,
  [in]  BYTE    size,
  [out] ULONG   *requestID
);

Параметры

[in] pduData

Строка, представляющая сообщение PDU в шестнадцатеричном формате.

[in] size

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

[out] requestID

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

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

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

Код возврата Описание
S_OK
 Метод завершился успешно.
E_INVALIDARG
 Недопустимые значения pduData или size .
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)
 Служба мобильной широкополосной связи не работает в этой системе.
E_HANDLE
 Недопустимый интерфейс, скорее всего, из-за того, что устройство было удалено из системы.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 Недопустимый интерфейс. Скорее всего, мобильное широкополосное устройство было удалено из системы.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Устройство не поддерживает отправку SMS-сообщений в запрошенном формате. Например, если эта функция вызывается для устройства CDMA.

Комментарии

Эти данные в pduData соответствуют структуре PDU, определенной в 3GPP TS 27.005 и 3GPP TS 23.040.

В приведенной ниже таблице показан пример структуры сообщения PDU, содержащего сообщение "Hello".

Пример 07 91198994000010 11000A9189945086180000AA05C8329BFD06
Содержимое Размер адреса центра обслуживания Адрес центра обслуживания PDU в шестнадцатеричном формате
Размер 1 байт Переменная Переменная
 

Эта функция должна вызываться только для устройств GSM, поддерживающих отправку SMS в формате PDU. Устройство сообщает об этой возможности, задав MBN_SMS_CAPS_PDU_SEND в MBN_INTERFACE_CAPS.

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

Требования

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

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

IMbnSms