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

重要

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

ネットワークを非同期的にスキャンして、表示されているプロバイダーの一覧を取得します。

構文

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

パラメーター

[out] requestID

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

戻り値

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

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

注釈

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

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

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

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

要件

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

こちらもご覧ください

IMbnInterface