DOT11_CIPHER_KEY_MAPPING_KEY_VALUE構造 (windot11.h)

[アーティクル]
08/08/2023

大事なネイティブ 802.11 ワイヤレス LAN インターフェイスは、Windows 10 以降では非推奨となりました。代わりに WLAN デバイスドライバーインターフェイス (WDI) を使用してください。 WDI の詳細については、「 WLAN ユニバーサル Windows ドライバーモデル」を参照してください。

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE構造体は、802.11 ステーションのキーテーブルに追加または削除されるキーマッピング暗号キーを定義します。この暗号キーの種類の詳細については、「 802.11 暗号キーの種類」を参照してください。

構文

typedef struct DOT11_CIPHER_KEY_MAPPING_KEY_VALUE {
  DOT11_MAC_ADDRESS      PeerMacAddr;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_DIRECTION        Direction;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_KEY_MAPPING_KEY_VALUE, *PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE;

メンバー

PeerMacAddr

ピアの MAC アドレス。ピアは、802.11 ステーションが関連付けられているアクセスポイント (AP) (インフラストラクチャ BSS ネットワークの場合) またはピアステーション (独立した BSS ネットワークの場合) のいずれかです。

このメンバーは、キーエントリを一意に識別するために使用されます。標準の 802.11 暗号アルゴリズムの場合、オペレーティングシステムはピアの MAC アドレスを介してピアを識別します。独立系ハードウェアベンダー (IHV) によって開発された独自の暗号アルゴリズムの場合、IHV は任意の方法を使用してキーエントリを識別できます。

NIC が拡張アクセスポイント (ExtAP) OP モードの場合、 PeerMacAddr には一意の値が必要です。

AlgorithmId

このキーを使用する暗号アルゴリズムの値。暗号アルゴリズムの列挙子値の詳細については、「 DOT11_CIPHER_ALGORITHM」を参照してください。

Direction

このメンバーは、802.11 ステーションが受信パケットまたは送信パケットにキーを使用するかどうかを指定します。このメンバーのデータ型は、DOT11_DIRECTION 列挙型です。

bDelete

TRUE に設定されている場合、ミニポートドライバーは PeerMacAddr および Direction によって参照されるキーを削除する必要があります。 FALSE に設定されている場合、ミニポートドライバーは PeerMacAddr と Direction によって参照されるキーを追加または更新する必要があります。

bStatic

ミニポートドライバーが接続またはローミング操作の後に既定のキーを削除する必要があるかどうかを指定するブール値。

FALSE に設定されている場合、ミニポートドライバーは、常に uKeyIndex によって参照される既定のキーを削除する必要があります。

802.11 ステーションは BSS ネットワークから切断されます。
ピアステーションは BSS ネットワークから切断されます。
802.11 ステーションは同じ BSS ネットワークに再接続します。

TRUE に設定すると、uKeyIndex によって参照される既定のキーは、次の場合を除き削除できません。

のセット要求を通じて明示的に削除された OID_DOT11_CIPHER_KEY_MAPPING_KEY。
OID_DOT11_RESET_REQUESTのメソッド要求によって暗黙的に削除されます。

usKeyLength

ucKey 配列内のキーマテリアルの長さ (バイト単位)。

ucKey[*]

キーマテリアル。

AlgorithmId が DOT11_CIPHER_ALGO_TKIP に設定されている場合、ucKey 配列はを使用してキーマテリアルを定義します。 DOT11_KEY_ALGO_TKIP_MIC 構造体。

AlgorithmId が DOT11_CIPHER_ALGO_CCMP に設定されている場合、ucKey 配列はを使用してキーマテリアルを定義します。 DOT11_KEY_ALGO_CCMP 構造体。

ucKey[1]

キーマテリアル。

AlgorithmId が DOT11_CIPHER_ALGO_TKIP に設定されている場合、ucKey 配列はを使用してキーマテリアルを定義します。 DOT11_KEY_ALGO_TKIP_MIC 構造体。

AlgorithmId が DOT11_CIPHER_ALGO_CCMP に設定されている場合、ucKey 配列はを使用してキーマテリアルを定義します。 DOT11_KEY_ALGO_CCMP 構造体。

注釈

Native 802.11 ミニポートドライバーは、 PeerMacAddr メンバーと Direction メンバーを介してキーマッピングキーを一意に識別します。 Windows コンピューターに OID_DOT11_CIPHER_KEY_MAPPING_KEY が設定されている場合、ミニポートドライバーは、Set 要求の PeerMacAddr メンバーと Direction メンバーの値が既存のキーのメンバーと一致する場合にのみ、既存のキーを変更または削除できます。

bDelete メンバーが TRUE の場合、次のメンバーは無効であり、無視する必要があります。

bStatic
usKeyLength
ucKey

要件

要件	値
サポートされている最小のクライアント	Windows Vista 以降のバージョンの Windows オペレーティングシステムで使用できます。
Header	windot11.h (Ndis.h を含む)