次の方法で共有

IMbnMultiCarrierEvents::OnScanNetworkComplete メソッド (mbnapi.h)

  • [アーティクル]

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。

この通知メソッドは、 ScanNetwork 操作の完了を示すためにモバイル ブロードバンド サービスによって呼び出されます。

構文

HRESULT OnScanNetworkComplete(
  [in] IMbnMultiCarrier *mbnInterface,
  [in] ULONG            requestID,
  [in] HRESULT          status
);

パラメーター

[in] mbnInterface

モバイル ブロードバンド デバイスの ScanNetwork 操作を表す IMbnMultiCarrier オブジェクト。

[in] requestID

Mobile Broadband サービスによって ScanNetwork 操作に割り当てられた要求 ID。

[in] status

ScanNetwork の結果を示す状態コード。

値 説明
S_OK
 操作に成功しました。
E_MBN_RADIO_POWER_OFF
 デバイス無線がオフになっているため、表示可能なネットワーク リストを取得できません。 アプリケーションは、無線オン通知を受け取ったときにネットワーク スキャン要求を発行できます。
E_MBN_DEVICE_BUSY
 デバイスはビジー状態であり、現在ネットワーク スキャン操作を実行できません。 これは、データ接続が確立されている場合にネットワーク スキャン操作をサポートしていないデバイスによって返されます。
E_MBN_ALREADY_ACTIVE
 ネットワーク スキャン操作は既に進行中です。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 この操作は、デバイスではサポートされていません。 これは、マルチキャリアをサポートしていないデバイスによって返される場合があります。

戻り値

このメソッドは 、S_OKを返す必要があります。

解説

状態がS_OK場合、モバイル ブロードバンド サービスは、表示されるプロバイダーのキャッシュされた一覧を正常に更新しました。 アプリケーションは、渡された IMbnMultiCarrier の GetVisibleProviders メソッドを呼び出して、表示されるプロバイダーの一覧を取得できます。

通知に複数のアプリケーションが登録されている場合は、登録されているすべてのアプリケーションでこのメソッドが呼び出されます。 つまり、更新操作を開始しなかったアプリケーションは通知を受け取ります。

要件

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

関連項目

IMbnMultiCarrierEvents