次の方法で共有

IMbnRadio::SetSoftwareRadioState メソッド (mbnapi.h)

  • [アーティクル]

重要

バージョン 1803 Windows 10以降、このセクションで説明する 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 メソッドを呼び出すことによって、無線状態の変更についてアプリケーションに通知します。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー mbnapi.h

こちらもご覧ください

IMbnRadio