IMbnSms：：SmsSendPdu 方法 (mbnapi.h)

重要

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

以 PDU 格式发送消息。

语法

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

[in] pduData

一个字符串，表示十六进制格式的 PDU 消息。

[in] size

转换为十六进制字符串格式并排除服务中心地址长度之前 PDU 消息的大小（字节数）。

[out] requestID

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

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

返回代码	说明
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)	设备不支持以请求的格式发送短信。例如，如果为 CDMA 设备调用此函数。

pduData 中的此数据符合 3GPP TS 27.005 和 3GPP TS 23.040 中定义的 PDU 结构。

下表显示了如何构建包含消息“Hello”的 PDU 消息的示例。

应仅对支持以 PDU 格式发送短信的 GSM 设备调用此函数。设备通过在 MBN_INTERFACE_CAPS 中设置MBN_SMS_CAPS_PDU_SEND来报告此功能。

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