OID_WWAN_PROVISIONED_CONTEXTS

OID_WWAN_PROVISIONED_CONTEXTS は、MB デバイスまたは加入者識別モジュール (SIM) に格納されているプロビジョニング済みコンテキスト エントリを読み取りまたは更新します。

ミニポート ドライバーは、set 要求と query 要求を非同期的に処理する必要があります。最初は元の要求に対して NDIS_STATUS_INDICATION_REQUIRED を返し、後で set 要求または query 要求の完了に関係なく MB デバイスまたは加入者識別モジュール (SIM) に格納されているプロビジョニングされたコンテキスト エントリに関する情報を提供するNDIS_WWAN_PROVISIONED_CONTEXTS構造体を含むNDIS_STATUS_WWAN_PROVISIONED_CONTEXTS状態通知を送信します。

解説

この OID の使用方法の詳細については、WWAN パケット コンテキスト管理を参照してください。

サポートする MB デバイスがプロビジョニングされたコンテキストの取得をサポートしていない場合、ミニポート ドライバーは NDIS_STATUS_NOT_SUPPORTED を返します。

GSM ベースのデバイスは、必要に応じて query 操作と set 操作をサポートします。 CDMA ベースのデバイスは、必要に応じて、Simple IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) を報告する query 操作をサポートします。

MB デバイスまたは SIM に格納されているプロビジョニング済みコンテキスト エントリは、デバイスに対してローカルです。 ミニポート ドライバーは、これらのフィールドを読み取るためにネットワークに接続しないでください。

set 要求の入力構造体は NDIS_WWAN_SET_PROVISIONED_CONTEXT であり、このオブジェクトの状態表示は NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS です。

プロビジョニングされたコンテキストは、APN のリストをキャッシュする 3GPP の GPRS コンテキスト定義と同じではありません。 プロビジョニングされたコンテキストは接続パラメーター (AccessString、UserName、Password) であり、オペレータによって事前にプロビジョニングされるか、またはデバイスによってプロビジョニングされる OTA のいずれかであり、デバイスメモリまたは SIM のいずれかに保存できます。 プロビジョニングされたコンテキストによって返される接続パラメーターは、MB サービスによって PDP のアクティベーション に使用されます。

このオブジェクトの query 形式と set 形式の両方が使用されます。

この要求の処理にはネットワーク アクセスは必要ありませんが、MB デバイス上の SIM または補助メモリへのアクセスが必要です。

ミニポート ドライバーは、オペレーティング システムに NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS 通知を送信します。 ContextListHeader.ElementType メンバーは WwanStructContextに設定されます。 set 要求に応答して通知が送信された場合、ミニポート ドライバは ContextListHeader.ElementCount メンバーを 0 に設定します。

MB サービスは、個々のコンテキストのアクティブ化または非アクティブ化を実行する前に、デバイスからプロビジョニングされたコンテキストの一覧を取得する必要があります。 プロビジョニングされたコンテキストの一覧は、デバイスに複数のネットワーク プロバイダー コンテキストを格納する機能がある場合でも、ホーム プロバイダー ネットワークのみに制限する必要があります。 ローミングの場合でも、コンテキストの一覧は常にホーム プロバイダー ネットワークに固有である必要があります。

SET OID_WWAN_PROVISIONED_CONTEXT 操作では、コンテキストを、WWAN_SET_CONTEXT構造体の ProviderId メンバ内の set 要求で指定されたネットワークプロバイダに関連付ける必要があります。 set OID_WWAN_PROVISIONED_CONTEXT 要求によって格納されるプロビジョニング済みコンテキストは、システムの再起動とデバイスの電源リサイクルの間で保持される必要があります。

すべての空のコンテキストは、ホーム プロバイダー ネットワークに適用できるプロビジョニングされたコンテキストと共に、クエリで報告される必要があります。

SimpleIP 用に構成され、WwanControlCaps の WWAN_CTRL_CAPS_CDMA_SIMPLE_IP で報告する CDMA デバイスは、必要に応じて、MB サービスからの query 要求に対する適切なAccessString、UserName、およびPasswordメンバーが記載されたプロビジョニング済みコンテキストを少なくとも 1 つ返すことができます。

プロビジョニングされたコンテキストリストは、デバイスで事前にプロビジョニングするか、set OID_WWAN_PROVISIONED_CONTEXT 操作で更新するか、SMS または OTA を使用してデバイス/オペレーターによって更新する必要があります。 MB サービスによってOID_WWAN_CONNECT 操作で提供されるコンテキスト情報に基づいて動的に更新することはできません。

リスト内のプロビジョニングされたコンテキストごとに、MB デバイスから AccessString、UserName、Passwordにアクセスする方法の詳細については、WWAN_CONTEXTを参照してください。

要件

バージョン	Windows 7 以降のバージョンの Windows で使用できます。
ヘッダー	Ntddndis.h (Ndis.h を含む)

関連項目

WWAN パケット コンテキスト管理