IMbnMultiCarrier::ScanNetwork メソッド (mbnapi.h)

重要

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

ネットワークをスキャンして、マルチキャリア デバイスの可視プロバイダーの一覧を取得します。

構文

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

パラメーター

[out] requestID

この要求のオペレーティング システムによって設定された要求 ID へのポインター。 OnScanNetworkComplete からの非同期応答には、この同じ requestID が含まれます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE	インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されているためです。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されているためです。
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	この操作は、デバイスではサポートされていません。 これは、マルチキャリアをサポートしていないデバイスによって返される場合があります。

注釈

このメソッドは、ネットワーク スキャン操作を開始します。 正常に完了すると、オペレーティング システムの可視プロバイダーのキャッシュが設定され、アプリケーションは IMbnMultiCarrier の GetVisibleProviders メソッドを呼び出して、表示可能なネットワークの一覧を取得できます。

これは時間のかかる操作です。 そのため、アプリケーションは最初に GetVisibleProviders を 呼び出し、キャッシュされた情報が古い場合にのみ ScanNetwork を呼び出す必要があります。

これは非同期操作であり、 ScanNetwork はすぐに返されます。 このメソッドが (S_OKで) 正常に返された場合、スキャン操作が完了すると、オペレーティング システムは IMbnMultiCarrierEvents の OnScanNetworkComplete メソッドを呼び出して、操作の完了をアプリケーションに通知します。

この操作が完了する前にデバイスがシステムから削除された場合、完了通知がアプリケーションによって受信される保証はありません。

要件

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

こちらもご覧ください

IMbnMultiCarrier