DOT11_CIPHER_DEFAULT_KEY_VALUE構造 (windot11.h)

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

重要

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

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

構文

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

メンバー

Header

DOT11_CIPHER_DEFAULT_KEY_VALUE構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、 ヘッダー のメンバーを次の値に設定する必要があります。

型

このメンバーは、NDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。

リビジョン

このメンバーは、DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1に設定する必要があります。

サイズ

このメンバーはに設定する sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE)必要があります。

これらのメンバーの詳細については、「 NDIS_OBJECT_HEADER」を参照してください。

uKeyIndex

802.11 ステーションの既定のキー配列内のキーのインデックス。

標準の 802.11 暗号アルゴリズムの場合、 uKeyIndex は 0 ~ 3 である必要があります。 IHV によって開発された暗号アルゴリズムの場合、 uKeyIndex には、IHV によって定義された範囲内の任意の値を指定できます。

BIP uKeyIndex の場合、4 または 5 である必要があります。

IEEE 802.11-2012 標準では、1 ~ 4 の既定のキーインデックス値が定義されています。このメンバーによって指定された値 x は、802.11 の既定のキーインデックス (x + 1) にマップされます。

AlgorithmId

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

BIP の場合、初期 IGTK パケット番号を事前に設定するには、DOT11_CIPHER_ALGO_BIPに設定する必要があります。

bDelete が TRUE の場合、ミニポートドライバーはこのメンバーを無視する必要があります。

MacAddr

キーを追加または削除する既定のキーテーブルを識別するメディアアクセス制御 (MAC) アドレス。

dot11DesiredBSSType 管理情報ベース (MIB) オブジェクトが dot11_BSS_type_infrastructure に設定されている場合、802.11 ステーションは、MacAddr メンバーの値に関係なく、既定のキーテーブルにキーを追加または削除します。キーがステーションが関連付けられているアクセスポイント (AP) から動的に取得される場合、 MacAddr メンバーには AP の MAC アドレスが含まれます。それ以外の場合、 MacAddr の値は 0x000000000000 になります。

dot11DesiredBSSType 管理情報ベース (MIB) オブジェクトがdot11_BSS_type_independentに設定されている場合、802.11 ステーションは次のようにキーを追加または削除する必要があります。

このメンバーの値が0x000000000000場合、802.11 ステーションは、既定のキーテーブルのキーを追加または削除します。 NIC が拡張アクセスポイント (ExtAP) OP モードの場合、この値は 0 です。
このメンバーの値が有効なユニキャスト MAC アドレスである場合、802.11 ステーションは、MAC アドレスが MacAddr の値と等しい独立 BSS (IBSS) ネットワークのピアステーションのステーションごとの既定のキーテーブルにキーを追加または削除します。

MacAddr の値にステーションごとの既定のキーテーブルが存在しない場合、802.11 ステーションは未使用のステーションごとの既定のキーテーブルを使用する必要があります。

dot11DesiredBSSType MIB オブジェクトの詳細については、「OID_DOT11_DESIRED_BSS_TYPE」を参照してください。

bDelete

ミニポートドライバーが既定のキーを削除するかどうかを指定するブール値。

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

bStatic

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

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

基本サービスセット (BSS) ネットワークから切断します。
新しい BSS ネットワークにローミングします。
同じ BSS ネットワークに再接続します。

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

OID_DOT11_CIPHER_DEFAULT_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構造体を介してキーマテリアルを定義します。

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

ucKey[1]

キーマテリアル。

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

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

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

注釈

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

bStatic
usKeyLength
ucKey

要件

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