IMbnInterfaceEvents::OnScanNetworkComplete メソッド (mbnapi.h)
重要
バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。
この通知方法は、ネットワーク スキャンの完了を示すために、モバイル ブロードバンド サービスによって呼び出されます。
構文
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
パラメーター
[in] newInterface
この操作が実行されたデバイスを表す IMbnInterface 。
[in] requestID
この通知のためにモバイル ブロードバンド サービスによって割り当てられた要求 ID。
[in] status
操作完了の状態
呼び出し元のアプリケーションでは、次のいずれかの値が必要です。
S_OK
操作に成功しました。
E_MBN_RADIO_POWER_OFF
デバイス無線がオフになっているため、表示されているネットワーク リストを取得できません。 アプリケーションは、無線オン通知を受け取ったときにネットワーク スキャン要求を発行できます。
E_MBN_DEVICE_BUSY
デバイスはビジー状態であり、現在ネットワーク スキャン操作を実行できません。 これは、データ接続が確立されている場合にネットワーク スキャン操作をサポートしていないデバイスによって返されます。
E_MBN_ALREADY_ACTIVE
ネットワーク スキャン操作は既に進行中です。
戻り値
このメソッドは 、S_OKを返す必要があります。
解説
操作が正常に完了した場合、つまり 状態 がS_OK場合、モバイル ブロードバンド サービスは、表示されているプロバイダーのキャッシュされた一覧を正常に更新しました。 アプリケーションは、渡された IMbnInterface の GetVisibleProviders メソッドを呼び出して、表示されているプロバイダーの一覧を取得できます。
通知に複数のアプリケーションが登録されている場合は、登録されているすべてのアプリケーションでこのメソッドが呼び出されます。 つまり、更新操作を開始しなかったアプリケーションは通知を受け取ります。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | mbnapi.h |