IMbnMultiCarrier

このインターフェイスは、対応するモバイルブロードバンドデバイスのマルチキャリア機能を公開します。

マルチキャリアデバイスのホームプロバイダーを更新します。

このメソッドは、次のいずれかの値を返すことがあります。

SetHomeProvider メソッドは、インターフェイスのホームプロバイダーの更新を開始します。これは非同期操作であり、メソッド呼び出しはただちに戻ります。このメソッドが S_OK で正常に戻った場合、Windows は IMbnMultiCarrierEvents の OnSetHomeProviderComplete メソッドを呼び出して、この操作の完了ステータスを呼び出し元アプリケーションに通知します。

その後、デバイスは自動的に新しいネットワークに登録された状態で起動し、登録状態の変更を通知します。SetHomeProvider を再度使用して新しいホームプロバイダーを設定しない限り、デバイスは Windows の再起動後もこの新しいホームネットワークに登録された状態で起動し続けます。

この操作が完了する前にデバイスがシステムから取り外された場合、完了通知が呼び出し元アプリケーションに届く保証はありません。

マルチキャリアデバイスについて、現在のエリアで表示される契約済みプロバイダーの一覧を、現在登録されているプロバイダーを除いて取得します。

このメソッドは、次のいずれかの値を返すことがあります。

GetPreferredProviders は、インターフェイスの優先プロバイダー一覧に格納されているプロバイダーの一覧を返します。

回復可能なエラーである E_MBN_PIN_REQUIRED、E_MBN_SIM_NOT_INSERTED、E_MBN_BAD_SIM の場合、モバイルブロードバンドサービスは、エラー状態が解消されたときにデバイスへプロバイダー一覧を再度問い合わせます。たとえば、プロバイダー一覧を取得するためにデバイスへの PIN の入力が必要な場合、GetPreferredProviders は E_MBN_PIN_REQUIRED を返します。アプリケーションが PIN を入力してデバイスのロックを解除すると、モバイルブロードバンドサービスは再度この情報をデバイスから取得しようとします。

回復可能なエラーが発生した後に Windows がプロバイダー一覧を取得するためにデバイスへ問い合わせている間、GetPreferredProviders はただちに E_PENDING を返します。新しい問い合わせが完了すると、適切なコールバックメソッドを使用して呼び出し元アプリケーションに通知が送信されます。たとえば、PIN によるロック解除操作が成功した後は、IMbnPinEvents の OnEnterComplete メソッドが呼び出されます。

モバイルブロードバンドサービスは、IMbnMultiCarrier の OnPreferredProvidersChange メソッドを呼び出して、新しい問い合わせのステータスをアプリケーションに通知します。

場合によっては、デバイスの優先プロバイダー一覧が SMS または OTA(over-the-air update、無線経由の更新)によってネットワーク経由で更新されることがあります。Windows は、IMbnMultiCarrier の OnPreferredProvidersChange メソッドを呼び出して、優先プロバイダー一覧の変更をアプリケーションに通知します。

優先プロバイダーの一覧は、ユーザーが複数の契約(少なくとも 2 つ以上)を持っている場合、またはデバイスが優先ネットワーク向けに事前プロビジョニングされていて、いずれかのネットワークのカバレッジエリア内にある場合に利用できます。ユーザーが複数のネットワークに契約していても、それらのカバレッジエリア外にいる場合は、この一覧が空になることがあります。この一覧には、ユーザーが契約している、またはデバイスが事前プロビジョニングされている、現在表示されているすべてのネットワークが含まれます(ただし現在登録されているネットワークは除きます)。

プロビジョニングによって、マルチキャリアデバイスの既存の優先一覧に新しいホームプロバイダーが追加されることもあります。これは SetHomeProvider を使用して行われます。

マルチキャリアデバイスについて、現在のエリアで表示されるプロバイダーの一覧を、優先プロバイダーおよび登録済みプロバイダーを除いて取得します。

このメソッドは、次のいずれかの値を返すことがあります。

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

頻繁なネットワークスキャン操作を避けるため、Windows は最近のスキャン操作の一覧を保持しており、プロバイダー一覧はキャッシュされた一覧から返されます。

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

この一覧には、ユーザーの現在地で利用可能な、現在表示されているすべてのネットワークが含まれます(ただし現在登録されているプロバイダーが報告するものと優先プロバイダーの一覧は除きます)。この一覧には、ユーザーがまだ契約していないネットワークのエントリが含まれます。この一覧により、ユーザーは新たに契約できる可能性のあるネットワークの選択肢を追加で得ることができます。

マルチキャリアデバイスがサポートするセルラークラスの一覧を取得します。

このメソッドは、次のいずれかの値を返すことがあります。

マルチキャリアデバイスの現在のセルラークラスを取得します。

このメソッドは、次のいずれかの値を返すことがあります。

マルチキャリアデバイスの表示プロバイダー一覧を取得するために、ネットワークをスキャンします。

このメソッドは、次のいずれかの値を返すことがあります。

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

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

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

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