DOT11_CIPHER_DEFAULT_KEY_VALUE構造 (windot11.h)
重要
ネイティブ 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 を含む) |