IMbnRadio：：SetSoftwareRadioState 方法 (mbnapi.h)

重要

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

设置移动宽带设备的软件无线电状态。

语法

HRESULT SetSoftwareRadioState(
  [in]  MBN_RADIO radioState,
  [out] ULONG     *requestID
);

[in] radioState

一个MBN_RADIO值，该值指定新的软件无线电状态。

[out] requestID

指向移动宽带服务分配的请求 ID 的指针，用于标识此请求。

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

返回代码	说明
S_OK	操作成功。
E_HANDLE	接口无效。移动宽带设备很可能已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	接口无效。很可能移动宽带设备已从系统中删除。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	移动宽带服务未在此系统上运行。

SetSoftwareRadioState 更改设备的软件无线电状态。这是一个异步操作，它将立即返回。完成后，移动宽带服务将调用 IMbnRadioEvents 接口的 OnSetSoftwareRadioStateComplete 方法。

禁用移动宽带设备的无线电将导致任何活动连接停用、网络数据包分离和网络注销。如果无线电关闭操作导致连接状态、数据包附加状态或网络注册状态发生更改，则应用程序将收到更改通知。

为移动宽带设备启用软件和硬件无线电后，它将自动尝试注册到网络。此外，某些设备可能还会尝试执行数据包附加到网络。每当状态更改时，调用应用程序都将收到有关网络注册和数据包附加状态更改的事件通知。

设备的无线电状态可以更改，而无需应用程序发出更改请求。例如，如果用户打开系统的硬件无线电开关。移动宽带服务将通过调用 IMbnRadioEvents 接口的 OnRadioStateChange 方法通知应用程序无线电状态的更改。