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

OID_WWAN_HOME_PROVIDER
WWAN_PROVIDER_STATE_FORBIDDEN

WWAN_PROVIDER_STATE_PREFERRED

OID_WWAN_PREFERRED_PROVIDERS
WWAN_PROVIDER_STATE_VISIBLE

WWAN_PROVIDER_STATE_REGISTERED

WWAN_PROVIDER_STATE_HOME

WWAN_PROVIDER_STATE_PREFERRED

WWAN_PROVIDER_STATE_FORBIDDEN

OID_WWAN_VISIBLE_PROVIDERS

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 を含む)

こちらもご覧ください

NDIS_WWAN_HOME_PROVIDER

NDIS_WWAN_PREFERRED_PROVIDERS

NDIS_WWAN_VISIBLE_PROVIDERS

WWAN_DEVICE_CAPS