Share via

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

  • [アーティクル]

重要

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

表示されているプロバイダーの一覧を取得します。

構文

HRESULT GetVisibleProviders(
  [out, retval] ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

パラメーター

[out, retval] age

デバイスから表示されるプロバイダー リストの最後の更新からの時間 (秒単位) へのポインター。

[out, retval] visibleProviders

インターフェイスのプロバイダーの一覧を含む MBN_PROVIDER 構造体の配列へのポインター。 このメソッドが S_OK 以外の値を返す場合、このパラメーターは NULL です。 それ以外の場合、呼び出し元のプログラムは、 SafeArrayDestroy を呼び出すことによって、割り当てられたメモリを解放する必要があります。

戻り値

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

リターン コード 説明
S_OK
 メソッドは正常に完了しました。 visibleProviders には有効な値が含まれています。 情報の経過時間に基づいて、呼び出し元のアプリケーションは ScanNetwork への新しい呼び出しを発行することを決定できます。
E_PENDING
 この情報は使用できません。 アクティブなネットワーク スキャンが進行中です。 呼び出し元のアプリケーションは、IMbnInterfaceEvents の OnScanNetworkComplete メソッドに登録することで、デバイス機能が使用可能になったときに通知を受け取ることができます。
E_MBN_INVALID_CACHE
 モバイル ブロードバンドの表示ネットワーク リストのキャッシュが無効です。 呼び出し元のアプリケーションは ScanNetwork を呼び出してキャッシュを設定する必要があります。

解説

このメソッドは、現在表示されているプロバイダーの一覧を返します。 CDMA デバイスは、優先ローミング リスト (PRL) 内のネットワークが使用可能な場合にのみ、ホーム プロバイダーを報告します。

頻繁なネットワーク スキャン操作を回避するために、オペレーティング システムは最近のスキャン操作の一覧を保持し、キャッシュされた一覧からプロバイダーの一覧が返されます。

アプリケーションはこのメソッドを呼び出して、 ScanNetwork の完了時に表示されるプロバイダーの一覧を取得できます。

要件

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

関連項目

IMbnInterface