DOT11_CIPHER_KEY_MAPPING_KEY_VALUE構造体 (windot11.h)
大事な
WiFiCx は、Windows 11 でリリースされた新しい Wi-Fi ドライバー モデルです。 最新の機能を利用するには、WiFiCx を使用することをお勧めします。 WDI ドライバー モデルはメンテナンス モードになり、優先度の高い修正プログラムのみを受け取ります。
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 と 方向 によって参照されるキーを削除する必要があります。 FALSE をに設定した場合、ミニポート ドライバーは、PeerMacAddr および Direction によって参照されるキー 追加または更新する必要があります。
bStatic
ミニポート ドライバーが接続またはローミング操作の後に既定のキーを削除する必要があるかどうかを指定するブール値。
FALSE 設定されている場合、ミニポート ドライバーは常に、uKeyIndex によって参照される既定のキーを削除する必要があります。
- 802.11 ステーションは BSS ネットワークから切断されます。
- ピア ステーションが BSS ネットワークから切断されます。
- 802.11 ステーションは、同じ BSS ネットワークに再接続します。
- のセット要求を通じて明示的に削除された 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 メンバーを介してキー マッピング キーを一意に識別します。 次の場合 OID_DOT11_CIPHER_KEY_MAPPING_KEY が設定されている場合、ミニポート ドライバーは、PeerMacAddr および Direction メンバーの値が既存のキーのメンバーと一致する場合にのみ、既存のキーを変更または削除できます。
bDelete メンバーが TRUE 場合、次のメンバーは無効であり、無視する必要があります。
- bStatic
- usKeyLength を する
- ucKey を する
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降のバージョンの Windows オペレーティング システムで使用できます。 |
| ヘッダー | windot11.h (Ndis.h を含む) |