IMbnSms::SetSmsConfiguration 方法 (mbnapi.h)

重要

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

汇报设备的 SMS 配置。

语法

HRESULT SetSmsConfiguration(
  [in]  IMbnSmsConfiguration *smsConfiguration,
  [out] ULONG                *requestID
);

参数

[in] smsConfiguration

一个 IMbnSmsConfiguration 接口,表示用于更新设备的新 SMS 配置。

[out] requestID

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

返回值

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

返回代码 说明
S_OK
该方法已成功完成。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)
移动宽带服务未在系统上运行。
E_HANDLE
接口无效,很可能是因为设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
接口无效。 很可能移动宽带设备已从系统中删除。

注解

应用程序可以使用 SetSmsConfiguration 修改设备中的默认 SMS 服务中心地址。

应用程序应执行以下步骤来设置设备的 SMS 配置。

  1. 通过调用 GetSmsConfiguration 获取 IMbnSmsConfiguration 接口。
  2. 使用反映所需配置更改的新值修改从步骤 1 获取的 IMbnSmsConfiguration 接口。
  3. 将修改后的 IMbnSmsConfiguration 传递给 SetSmsConfiguration
这是将立即返回的异步操作。 如果方法返回时没有错误,则移动宽带服务将调用 IMbnSmsEvents 接口的 OnSetSmsConfigurationComplete 方法。

要求

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

另请参阅

IMbnSms

IMbnSmsConfiguration