IMbnMultiCarrier::GetVisibleProviders メソッド (mbnapi.h)
重要
バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows ランタイム API に置き換えられます。
マルチキャリア デバイスの現在の領域に表示されているプロバイダーの一覧から優先プロバイダーと登録済みプロバイダーを差し引いた値を取得します。
構文
HRESULT GetVisibleProviders(
[out] ULONG *age,
[out, retval] SAFEARRAY **visibleProviders
);
パラメーター
[out] age
デバイスの表示プロバイダー リストの最後の更新以降の時間 (秒単位) へのポインター。
[out, retval] visibleProviders
インターフェイスのプロバイダーの一覧を含む MBN_PROVIDER2 構造体の配列へのポインター。 このメソッドが S_OK以外の値を返す場合、 visibleProviders は NULL です。 GetVisibleProviders がS_OKを返す場合、呼び出し元のアプリケーションは SafeArrayDestroy を呼び出して、割り当てられたメモリを解放する必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード | 説明 |
---|---|
|
メソッドは正常に完了しました。 visibleProviders には有効な値が含まれています。 情報の経過時間に基づいて、呼び出し元のアプリケーションは ScanNetwork への新しい呼び出しを発行することを決定できます |
|
この情報は使用できません。 アクティブなネットワーク スキャンが進行中です。 呼び出し元のアプリケーションは、IMbnMultiCarrierEvents の OnScanNetworkComplete メソッドに登録することで、デバイス機能が使用可能になったときに通知を受け取ることができます |
|
モバイル ブロードバンドの表示可能なネットワーク リストのキャッシュが無効です。 呼び出し元のアプリケーションは ScanNetwork を呼び出してキャッシュを設定する必要があります。 |
|
この操作は、デバイスではサポートされていません。 これは、マルチキャリアをサポートしていないデバイスによって返される場合があります。 |
注釈
このメソッドは、現在表示されているプロバイダーの一覧を返します。 CDMA デバイスは、優先ローミング リスト (PRL) 内のネットワークが使用可能な場合にのみ、ホーム プロバイダーを報告します。
頻繁なネットワーク スキャン操作を回避するために、Windows は最近のスキャン操作の一覧を保持し、キャッシュされた一覧からプロバイダーの一覧が返されます。
アプリケーションはこのメソッドを呼び出して、 ScanNetwork の完了時に表示されるプロバイダーの一覧を取得できます。
この一覧には、現在登録されているプロバイダーによって報告されたネットワークと優先プロバイダーの一覧を除き、ユーザーの場所で使用できる現在表示されているすべてのネットワークが含まれます。 この一覧には、ユーザーがサブスクライブしていないネットワーク エントリが含まれています。 この一覧では、ユーザーがサインアップする可能性がある追加のネットワーク選択セットをユーザーに提供します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | mbnapi.h |