IMbnSms：：SmsSendCdma 方法 (mbnapi.h)

  • 项目

重要

从 Windows 10 版本 1803 开始，本部分所述的 Win32 API 将替换为 Windows.Networking.Connectivity 命名空间中的Windows 运行时 API。

发送 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
);

parameters

[in] address

包含接收方电话号码的 null 终止字符串。 字符串的最大大小为 15 位。

[in] encoding

指定数据编码 的MBN_SMS_CDMA_ENCODING 值。

[in] language

指定语言的MBN_SMS_CDMA_LANG值。

[in] sizeInCharacters

消息中的编码字符数。 这可以不同于消息数组的大小。

[in] message

包含编码的 CDMA 消息的字节数组。

此数组的最大大小是 IMbnSmsConfiguration 的 CdmaShortMsgSize 属性，但这不能大于 MBN_CDMA_SHORT_MSG_SIZE_MAX (160) 。

[out] requestID

指向移动宽带服务颁发的用于标识此请求的请求 ID 的指针。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
 该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在此系统上运行。
E_HANDLE
 接口无效，很可能是因为设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 移动宽带设备很可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_SUPPORTED)
设备不支持以请求的格式发送短信。 例如，如果为 GSM 设备调用此函数。

注解

此方法可用于为 CDMA 设备发送短信。 但是，仅当 CDMA 设备支持发送短信时才会出现这种情况。 调用应用程序可以通过调用 IMbnInterface 的 GetInterfaceCapability 方法了解设备是否支持此格式。 然后，它可以在 MBN_INTERFACE_CAPS 的 smsCaps 成员中查找 MBN_SMS_CAPS_TEXT_SEND。

地址参数可以采用以下任一格式。

  • “+ <国际国家/地区代码><短信服务中心号码>\0”
  • “<SMS 服务中心号码>\0”

这是将立即返回的异步操作。 如果方法返回时未出错，则移动宽带服务将调用 IMbnSmsEvents 接口的 OnSmsSendComplete 方法。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 mbnapi.h

另请参阅

IMbnSms