IMbnConnectionContext::GetProvisionedContexts メソッド (mbnapi.h)
重要
バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。
接続コンテキストの一覧を取得します。
構文
HRESULT GetProvisionedContexts(
[out, retval] SAFEARRAY **provisionedContexts
);
パラメーター
[out, retval] provisionedContexts
デバイスに格納されている接続コンテキストを表す MBN_CONTEXT 値の一覧。 エラーが発生した場合、この配列は NULL です。 成功した場合、呼び出し元のアプリケーションは SafeArrayDestroy を呼び出して、割り当てられたメモリを解放する必要があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
メソッドは正常に完了しました。 |
|
接続コンテキストは使用できません。 モバイル ブロードバンド サービスは、デバイスの情報をプローブしています。 呼び出し元のアプリケーションは、IMbnConnectionContextEvents の OnProvisionedContextListChange メソッドに登録することで、接続コンテキストが使用可能になったときに通知を受け取ることができます。 |
|
接続コンテキストを取得するには、PIN が必要です。 |
|
SIM はデバイスに挿入されません。 |
|
デバイスに不適切な SIM が挿入されます。 |
|
デバイスは、プロビジョニングされたコンテキストの取得をサポートしていません。 |
解説
接続コンテキストは、レイヤー 2 の物理モバイル ブロードバンド接続の上に仮想回線またはフローを設定するためのネットワーク構成パラメーターの特定のセットを抽象化したものです。 GSM では、PDP コンテキストの概念に対応します。CDMA では、ネットワーク プロファイルに対応します。
場合によっては、接続パラメーターは既にデバイス/SIM メモリで使用できます。 このメソッドを使用すると、現在のホーム プロバイダー ネットワークのデバイスに格納されている、格納されている接続コンテキストの一覧を取得できます。
データ接続には 、MBN_CONTEXT_TYPE_INTERNET 型のコンテキストのみを使用する必要があります。
デバイスは、現在のホーム プロバイダーに格納されているすべてのコンテキストを返します。 一部のコンテキストは空にすることができ、 MBN_CONTEXT_TYPE_NONEとして報告されます。
場合によっては、SMS または OTA を介して、保存されたプロビジョニングされたコンテキストをネットワークによって更新できます。 デバイスプロビジョニングされたコンテキストに変更が加わるたびに、モバイル ブロードバンド サービスは IMbnConnectionContextEvents の OnProvisionedContextListChange メソッドを呼び出します。 その後、アプリケーションはこのメソッドを使用して、プロビジョニングされたコンテキストの更新された一覧を取得できます。
回復可能なエラー E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED、 およびE_MBN_BAD_SIMの場合、モバイル ブロードバンド サービスは、エラー状態が終わったときに、この情報についてデバイスに再度クエリを実行します。 たとえば、デバイスが接続コンテキストを取得するために PIN を入力する必要がある場合は、 E_MBN_PIN_REQUIREDを返します。 アプリケーションが PIN を入力してデバイスのロックを解除すると、サービスはデバイスからこの情報を取得しようとします。 サービスは、IMbnConnectionContextEvents の OnProvisionedContextListChange メソッドを呼び出すことによって、新しいクエリの状態に関するアプリケーションを更新します。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | mbnapi.h |