struktur DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Artikel
03/01/2024

Penting Antarmuka LAN Nirkabel Native 802.11 tidak digunakan lagi di Windows 10 dan yang lebih baru. Silakan gunakan WLAN Device Driver Interface (WDI) sebagai gantinya. Untuk informasi selengkapnya tentang WDI, lihat WLAN Universal Windows driver model.

Struktur DOT11_CIPHER_KEY_MAPPING_KEY_VALUE mendefinisikan kunci sandi pemetaan kunci yang akan ditambahkan atau dihapus dari tabel kunci pada stasiun 802.11. Untuk informasi selengkapnya tentang jenis kunci cipher ini, lihat Jenis Kunci Sandi 802.11.

Sintaks

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;

Anggota

PeerMacAddr

Alamat MAC serekan. Peer adalah titik akses (AP) (untuk jaringan BSS infrastruktur) atau stasiun serekan (untuk jaringan BSS independen) yang terkait dengan stasiun 802.11.

Anggota ini digunakan untuk mengidentifikasi entri kunci secara unik. Untuk algoritma sandi 802.11 standar, sistem operasi akan mengidentifikasi serekan melalui alamat MAC serekan. Untuk algoritma sandi kepemilikan yang dikembangkan oleh vendor perangkat keras independen (IHV), IHV dapat menggunakan metode apa pun untuk mengidentifikasi entri kunci.

Ketika NIC berada dalam mode OP Extensible Access Point (ExtAP), PeerMacAddr harus memiliki nilai yang unik.

AlgorithmId

Nilai algoritma sandi yang menggunakan kunci ini. Untuk informasi selengkapnya tentang nilai enumerator untuk algoritma sandi, lihat DOT11_CIPHER_ALGORITHM.

Direction

Anggota ini menentukan apakah stasiun 802.11 menggunakan kunci untuk menerima atau mengirimkan paket. Jenis data untuk anggota ini adalah enumerasi DOT11_DIRECTION .

bDelete

Jika diatur ke TRUE, driver miniport harus menghapus kunci yang direferensikan oleh PeerMacAddr dan Direction . Jika diatur ke FALSE, driver miniport harus menambahkan atau memperbarui kunci yang direferensikan oleh PeerMacAddr dan Direction .

bStatic

Nilai Boolean yang menentukan apakah driver miniport harus menghapus kunci default setelah koneksi atau operasi roaming.

Jika diatur ke FALSE, driver miniport harus menghapus kunci default yang dirujuk oleh uKeyIndex setiap kali:

Stasiun 802.11 terputus dari jaringan BSS.
Stasiun serekan terputus dari jaringan BSS.
Stasiun 802.11 terhubung kembali ke jaringan BSS yang sama.

Jika diatur ke TRUE, kunci default yang dirujuk oleh uKeyIndex tidak boleh dihapus kecuali:

Dihapus secara eksplisit melalui permintaan set OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Secara implisit dihapus melalui permintaan metode OID_DOT11_RESET_REQUEST.

usKeyLength

Panjangnya, dalam byte, dari bahan kunci dalam array ucKey .

ucKey[*]

Bahan utama.

Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_TKIP, array ucKey menentukan materi kunci melalui DOT11_KEY_ALGO_TKIP_MIC struktur.

Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_CCMP, array ucKey menentukan materi kunci melalui DOT11_KEY_ALGO_CCMP struktur.

ucKey[1]

Bahan utama.

Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_TKIP, array ucKey menentukan materi kunci melalui DOT11_KEY_ALGO_TKIP_MIC struktur.

Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_CCMP, array ucKey menentukan materi kunci melalui DOT11_KEY_ALGO_CCMP struktur.

Keterangan

Driver miniport Native 802.11 secara unik mengidentifikasi kunci pemetaan kunci melalui anggota PeerMacAddr dan Direction . Ketika OID_DOT11_CIPHER_KEY_MAPPING_KEY diatur, driver miniport dapat memodifikasi atau menghapus kunci yang ada hanya jika nilai anggota PeerMacAddr dan Direction dari permintaan yang ditetapkan cocok dengan anggota kunci yang ada.

Jika anggota bDeleteTRUE, anggota berikut tidak valid dan harus diabaikan: