WWAN_PROVIDER 構造体 (wwan.h)
WWAN_PROVIDER構造体は、ネットワーク プロバイダーに関する詳細を表します。
構文
typedef struct _WWAN_PROVIDER {
WCHAR ProviderId[WWAN_PROVIDERID_LEN];
ULONG ProviderState;
WCHAR ProviderName[WWAN_PROVIDERNAME_LEN];
ULONG WwanDataClass;
} WWAN_PROVIDER, *PWWAN_PROVIDER;
メンバー
ProviderId[WWAN_PROVIDERID_LEN]
ネットワーク プロバイダー ID を表す NULL で終わる数値 (0 から 9) の文字列。
GSM ベースのネットワークの場合、この文字列は 3 桁のモバイル国コード (MCC) と 2 桁または 3 桁のモバイル ネットワーク コード (MNC) を連結したものです。 GSM ベースの通信事業者には、複数の MNC があり、そのため、複数の ProviderId が含まれる場合があります。
CDMA ベースのネットワークの場合、この文字列は 5 桁のシステム ID (SID) です。 一般に、CDMA ベースの通信事業者には複数の SID があります。 通常、通信事業者は市場ごとに 1 つの SID を持っています。これは通常、アメリカの米国のメトロポリタン統計地域 (MSA) などの規制によって国内で地理的に分割されます。 CDMA ベースのデバイスのミニポート ドライバーは、この情報が利用できない場合はWWAN_CDMA_DEFAULT_PROVIDER_IDを指定する必要があります。
ProviderState
ネットワーク プロバイダーのエントリにタグを付けることができるさまざまな状態を表す 値。 次の表は、ミニポート ドライバーが指定する必要がある値を示しています (1 つ以上の値を指定できます)。
| 値 | 意味 |
|---|---|
| WWAN_PROVIDER_STATE_HOME | ネットワーク プロバイダーはホーム オペレーターです。 |
| WWAN_PROVIDER_STATE_FORBIDDEN | ネットワーク プロバイダーは禁止リストにあります。 |
| WWAN_PROVIDER_STATE_PREFERRED | ネットワーク プロバイダーが優先リストに表示されます。 |
| WWAN_PROVIDER_STATE_VISIBLE | ネットワーク プロバイダーが表示されます。 |
| WWAN_PROVIDER_STATE_REGISTERED | ネットワーク プロバイダーは現在、デバイスによって登録されています。 |
| WWAN_PROVIDER_STATE_UNKNOWN | ネットワーク プロバイダーの状態が不明です。 |
前の表の一部の値は、特定のオブジェクト識別子 (OID) にのみ適用されます。 次の表は、これらの値と関連する OID の間の関連付けを示しています。
| 値 | OID |
|---|---|
| WWAN_PROVIDER_STATE_HOME | |
|
WWAN_PROVIDER_STATE_FORBIDDEN WWAN_PROVIDER_STATE_PREFERRED |
|
|
WWAN_PROVIDER_STATE_VISIBLE WWAN_PROVIDER_STATE_REGISTERED WWAN_PROVIDER_STATE_HOME WWAN_PROVIDER_STATE_PREFERRED WWAN_PROVIDER_STATE_FORBIDDEN |
ProviderName[WWAN_PROVIDERNAME_LEN]
ネットワーク プロバイダーの名前を表す NULL で終わる文字列。 このメンバーは、最大でWWAN_PROVIDERNAME_LEN文字に制限されます。
GSM ベースのネットワークの場合、国のイニシャルとモバイル ネットワーク名 (PPCI&N) の優先プレゼンテーションがWWAN_PROVIDERNAME_LEN文字よりも長い場合、ミニポート ドライバーはネットワーク名を省略する必要があります。
MB サービスが優先プロバイダー リストを設定する場合、このメンバーは無視されます。
ミニポート ドライバーは、この情報を持たないデバイスの NULL 文字列を指定する必要があります。
WwanDataClass
デバイスがサポートするデータ クラスを表すビットマップ。 値の詳細な一覧については、WWAN_DEVICE_CAPSの WwanDataClass メンバーを参照してください。
このメンバーは、OID_WWAN_HOME_PROVIDERに対してクエリを実行するときに無視できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 以降のバージョンの Windows で使用できます。 |
| Header | wwan.h (Wwan.h を含む) |