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

Важно!

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

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

Синтаксис

HRESULT SmsSendCdma(
  [in]  LPCWSTR               address,
  [in]  MBN_SMS_CDMA_ENCODING encoding,
  [in]  MBN_SMS_CDMA_LANG     language,
  [in]  ULONG                 sizeInCharacters,
  [in]  SAFEARRAY             *message,
  [out] ULONG                 *requestID
);

Параметры

[in] address

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

[in] encoding

Значение MBN_SMS_CDMA_ENCODING , указывающее кодировку данных.

[in] language

Значение MBN_SMS_CDMA_LANG , указывающее язык.

[in] sizeInCharacters

Количество закодированных символов в сообщении. Это может отличаться от размера массива сообщений.

[in] message

Массив байтов, содержащий закодированное сообщение CDMA.

Максимальный размер этого массива — свойство CdmaShortMsgSizeобъекта IMbnSmsConfiguration, однако это значение не может превышать MBN_CDMA_SHORT_MSG_SIZE_MAX (160).

[out] requestID

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

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

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

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

Комментарии

Этот метод можно использовать для отправки SMS-сообщения для устройства CDMA. Однако это происходит только в том случае, если устройство CDMA поддерживает отправку SMS. Вызывающее приложение может узнать, поддерживает ли устройство этот формат, вызвав метод GetInterfaceCapabilityдля IMbnInterface. Затем он может искать MBN_SMS_CAPS_TEXT_SEND в элементе smsCapsMBN_INTERFACE_CAPS.

Параметр address может иметь любой из этих форматов.

• "+ <Международный код><страны SMS Service Center Number>\0"
• "<Номер> центра обслуживания SMS\0"

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

Требования

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

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

IMbnSms