次の方法で共有


WLAN_BSS_ENTRY 構造体 (wlanapi.h)

WLAN_BSS_ENTRY構造体には、基本的なサービス セット (BSS) に関する情報が含まれています。

構文

typedef struct _WLAN_BSS_ENTRY {
  DOT11_SSID        dot11Ssid;
  ULONG             uPhyId;
  DOT11_MAC_ADDRESS dot11Bssid;
  DOT11_BSS_TYPE    dot11BssType;
  DOT11_PHY_TYPE    dot11BssPhyType;
  LONG              lRssi;
  ULONG             uLinkQuality;
  BOOLEAN           bInRegDomain;
  USHORT            usBeaconPeriod;
  ULONGLONG         ullTimestamp;
  ULONGLONG         ullHostTimestamp;
  USHORT            usCapabilityInformation;
  ULONG             ulChCenterFrequency;
  WLAN_RATE_SET     wlanRateSet;
  ULONG             ulIeOffset;
  ULONG             ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;

メンバー

dot11Ssid

BSS に関連付けられているアクセス ポイント (AP) またはピア ステーションの SSID。 このメンバーのデータ型は 、DOT11_SSID 構造体です。

uPhyId

ワイヤレス LAN インターフェイスが BSS ネットワークを検出するために使用した PHY の識別子 (ID)。

dot11Bssid

スキャン中にワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームを送信した、インフラストラクチャ BSS ネットワークまたは独立した BSS ネットワーク (アドホック ネットワーク) のピア ステーションのアクセス ポイントのメディア アクセス制御 (MAC) アドレス。 このメンバーのデータ型は 、DOT11_MAC_ADDRESS 構造体です。

dot11BssType

BSS ネットワークの種類。 このメンバーのデータ型は 、DOT11_BSS_TYPE 列挙値です。

このメンバーには、次のいずれかの値を指定できます。

意味
dot11_BSS_type_infrastructure
1
インフラストラクチャ BSS ネットワークを指定します。
dot11_BSS_type_independent
2
独立した BSS (IBSS) ネットワーク (アドホック ネットワーク) を指定します。

dot11BssPhyType

このネットワークの PHY の種類。 このメンバーのデータ型は 、DOT11_PHY_TYPE 列挙値です。

lRssi

AP またはピア ステーションのワイヤレス LAN インターフェイス ドライバーによって検出された、1.0 ミリワット (dBm) を参照するデシベル単位の受信信号強度インジケーター (RSSI) 値。

uLinkQuality

ワイヤレス LAN インターフェイス ドライバーによって報告されるリンク品質。 リンク品質の値の範囲は 0 ~ 100 です。 値 100 は、最高のリンク品質を指定します。

bInRegDomain

国/地域によって識別される規制ドメイン内で AP ステーションまたはピア ステーションが動作しているかどうかを示す 値です。

ワイヤレス LAN インターフェイス ドライバーが複数の規制ドメインをサポートしていない場合、このメンバーは TRUE に設定されます。

AP またはピア ステーションから受信した 802.11 ビーコンまたはプローブ応答フレームに Country information 要素 (IE) が含まれていない場合、このメンバーは TRUE に設定されます。

AP またはピア ステーションから受信した 802.11 ビーコンまたはプローブ応答フレームに Country IE が含まれている場合、Country String サブフィールドの値が入力国文字列と等しくない場合、このメンバーは FALSE に 設定されます。

usBeaconPeriod

ワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームからのビーコン間隔フィールドの値。

この間隔は、ターゲット ビーコン送信時間の間の 1,024 マイクロ秒の時間単位です。 この情報は、インフラストラクチャ BSS ネットワーク内のアクセス ポイントによって送信されたビーコン パケット、またはプローブ要求を送信するワイヤレス LAN クライアントへの応答として、アクセス ポイントまたはピア ステーションからのプローブ応答から取得されます。

IEEE 802.11 標準では、時間の単位が 1,024 マイクロ秒と定義されています。 このユニットは、ハードウェアに簡単に実装できるように定義されています。

ullTimestamp

ワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームの Timestamp フィールドの値。

ullHostTimestamp

ワイヤレス LAN インターフェイスがビーコンまたはプローブ応答フレームを受信したときに記録するホスト タイムスタンプ値。 このメンバーは、1601 年 1 月 1 日以降の 100 ナノ秒間隔のカウントです。

詳細については、WDK に記載されている NdisGetCurrentSystemTime 関数を参照してください。

usCapabilityInformation

ワイヤレス LAN インターフェイスによって受信された 802.11 ビーコンまたはプローブ応答フレームの [機能情報] フィールドの値。 この値は、機能を定義するビット フラグのセットです。

このメンバーには、次の値の 1 つ以上を指定できます。

意味
Ess
ビット 0
拡張サービス セット。 1 つ以上の相互接続された基本サービス セット (BSS) と統合ローカル エリア ネットワーク (LAN) のセット。これらの BSS のいずれかに関連付けられている任意のステーションの論理リンク制御レイヤーへの単一の BSS として表示されます。

AP は ESS サブフィールドを 1 に設定し、IBSS サブフィールドを送信されたビーコンまたはプローブ応答フレーム内で 0 に設定します。 IBSS (アドホック ネットワーク) 内のピア ステーションは、送信されたビーコンまたはプローブ応答フレームで ESS サブフィールドを 0 に、IBSS サブフィールドを 1 に設定します。

Ibss
ビット 1
独立した基本サービス セット。 自己完結型ネットワークを形成し、配布システム (DS) へのアクセスが利用できない BSS (アドホック ネットワーク)。

AP は ESS サブフィールドを 1 に、IBSS サブフィールドを送信されたビーコンまたはプローブ応答フレーム内で 0 に設定します。 IBSS (アドホック ネットワーク) 内のピア ステーションは、送信されたビーコンまたはプローブ応答フレームで ESS サブフィールドを 0 に、IBSS サブフィールドを 1 に設定します。

CF-Pollable
ビット 2
AP またはピア ステーションがポーリング可能かどうかを示す 値。
CF ポーリング要求
ビット 3
AP またはピア ステーションがポーリング要求を処理する方法を示す 値。
プライバシー
ビット 4
すべてのデータ フレームに暗号化が必要かどうかを示す 値。

BSS 内で交換されるすべてのデータ型フレームに WEP、WPA、または WPA2 暗号化が必要な場合、AP は送信されたビーコンおよびプローブ応答フレーム内でプライバシー サブフィールドを 1 に設定します。 WEP、WPA、または WPA2 暗号化が不要な場合、Privacy サブフィールドは 0 に設定されます。

IBSS 内で交換されるすべてのデータ型フレームに WEP、WPA、または WPA2 暗号化が必要な場合、IBSS 内のピア ステーションは、送信されたビーコンおよびプローブ応答フレーム内のプライバシー サブフィールドを 1 に設定します。 WEP、WPA、または WPA2 暗号化が不要な場合、Privacy サブフィールドは 0 に設定されます。

ulChCenterFrequency

802.11 ビーコンまたはプローブ応答フレームを受信したバンドのチャネル中心周波数。 ulChCenterFrequency の値は、キロヘルツ (kHz) 単位です。

メモ このメンバーは、周波数ホッピング 拡散スペクトル (FHSS) ではない PHY タイプに対してのみ有効です。
 

wlanRateSet

BSS でサポートされている一連のデータ転送レート。 このメンバーのデータ型は 、WLAN_RATE_SET 構造体です。

ulIeOffset

WLAN_BSS_ENTRY構造体の先頭からの情報要素 (IE) データ BLOB のオフセット (バイト単位)。

このメンバーは、802.11 ビーコンまたはプローブ応答フレームからの可変長情報要素 (IEs) を含むバッファーを指します。 各 BSS について、その BSS ネットワークから受信した最後のビーコンまたはプローブ応答フレームからの IEs です。 IE が 1 つのフレームでのみ使用できる場合、ワイヤレス LAN インターフェイス ドライバーは、最後に受信したビーコンまたはプローブ応答フレームの他の IEs と IE をマージします。

情報要素は、IEEE 802.11 仕様で定義され、1 バイトの要素 ID フィールド、1 バイトの Length フィールド、可変長要素固有の情報フィールドで構成される共通の一般的な形式を持ちます。 各情報要素には、この IEEE 802.11 標準で定義されている一意の要素 ID 値が割り当てられます。 [長さ] フィールドでは、情報フィールドのバイト数を指定します。

ulIeSize

WLAN_BSS_ENTRY構造体内の IE データ BLOB のサイズ (バイト単位)。

これは 、ulIeOffset メンバーが指すバッファー内のデータの正確な長さであり、配置用のパディングは含まれません。 IE データ BLOB のサイズの最大値は 2,324 バイトです。

注釈

WlanGetNetworkBssList 関数は、特定のインターフェイス上のワイヤレス ネットワークまたはネットワークの BSS リストを取得し、 の配列を含むWLAN_BSS_LIST構造体でこの情報を返します。WLAN_BSS_ENTRY構造体。

ワイヤレス LAN インターフェイスがワイヤレス ホステッド ネットワークとしても動作している場合、BSS リストには、ワイヤレス ホステッド ネットワーク用に作成された BSS のエントリが含まれます。

情報はインフラストラクチャ BSS ネットワークのアクセス ポイントまたは独立した BSS ネットワーク (アドホック ネットワーク) のネットワーク ピアによって返されるため、返される情報は信頼できません。 WLAN_BSS_ENTRY構造体の ulIeOffset メンバーと ulIeSize メンバーを使用して、情報要素データ BLOB のデータではなく、WLAN_BSS_ENTRY構造体内の情報要素データ BLOB の最大サイズを決定する必要があります。

要件

要件
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
Header wlanapi.h

こちらもご覧ください

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList