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

行動寬頻服務指派的要求標識碼指標，用來識別此要求。

這個方法可以傳回其中一個值。

傳回碼	描述
S_OK	作業成功。
E_HANDLE	介面無效。最有可能是，行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)	介面無效。最有可能是行動寬頻裝置已從系統中移除。
HRESULT_FROM_WIN32 (ERROR_SERVICE_NOT_ACTIVE)	行動寬頻服務未在此系統上執行。

SetSoftwareRadioState 會變更裝置的軟體無線電狀態。這是異步操作，它會立即傳回。完成時，行動寬頻服務會呼叫 IMbnRadioEvents 介面的 OnSetSoftwareRadioStateComplete 方法。

停用行動寬頻裝置的無線電會導致任何作用中連線、網路封包中斷連結，以及網路取消註冊。如果無線電關閉作業導致連線狀態、封包附加狀態或網路註冊狀態變更，則應用程式會收到變更的通知。

當行動寬頻裝置同時啟用軟體和硬體無線電時，會自動嘗試向網路註冊。此外，有些裝置可能也會嘗試執行封包連結至網路。每當狀態變更時，呼叫的應用程式將會收到網路註冊和封包附加狀態變更的事件通知。

裝置的無線電狀態可以變更，而不需從應用程式變更要求。例如，如果使用者開啟系統的硬體無線電交換器。行動寬頻服務會呼叫 IMbnRadioEvents 介面的 OnRadioStateChange 方法，通知應用程式有關無線電狀態的變更。