struktur DOT11_CIPHER_DEFAULT_KEY_VALUE (windot11.h)
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_DEFAULT_KEY_VALUE mendefinisikan kunci cipher default atau kunci cipher default per stasiun yang akan ditambahkan ke 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_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;
Anggota
Header
Jenis, revisi, dan ukuran struktur DOT11_CIPHER_DEFAULT_KEY_VALUE. Anggota ini diformat sebagai struktur NDIS_OBJECT_HEADER .
Driver miniport harus mengatur anggota Header ke nilai berikut:
Jenis
Anggota ini harus diatur ke NDIS_OBJECT_TYPE_DEFAULT.
Revisi
Anggota ini harus diatur ke DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1.
Ukuran
Anggota ini harus diatur ke sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE).
Untuk informasi selengkapnya tentang anggota ini, lihat NDIS_OBJECT_HEADER.
uKeyIndex
Indeks kunci dalam array kunci default stasiun 802.11.
Untuk algoritma cipher 802.11 standar, uKeyIndex harus dari 0 hingga 3. Untuk algoritma sandi yang dikembangkan oleh IHV, uKeyIndex dapat menjadi nilai apa pun dalam rentang yang ditentukan oleh IHV.
Untuk BIP uKeyIndex harus 4 atau 5.
Standar IEEE 802.11-2012 menentukan nilai indeks kunci default dari 1 hingga 4. Nilai x yang ditentukan oleh anggota ini memetakan ke indeks kunci default 802.11 (x + 1).
AlgorithmId
Nilai algoritma sandi yang menggunakan kunci ini. Untuk informasi selengkapnya tentang nilai untuk algoritma sandi, lihat DOT11_CIPHER_ALGORITHM.
Untuk BIP, ini harus diatur ke DOT11_CIPHER_ALGO_BIP untuk mengatur nomor paket IGTK awal.
Driver miniport harus mengabaikan anggota ini jika bDeleteTRUE.
MacAddr
Alamat kontrol akses media (MAC), yang mengidentifikasi tabel kunci default untuk menambahkan atau menghapus kunci.
Jika objek basis informasi manajemen dot11DesiredBSSType (MIB) diatur ke dot11_BSS_type_infrastructure, stasiun 802.11 menambahkan atau menghapus kunci dari tabel kunci default terlepas dari nilai anggota MacAddr . Jika kunci diperoleh secara dinamis dari titik akses (AP) yang terkait dengan stasiun, anggota MacAddr akan berisi alamat MAC AP. Jika tidak, MacAddr akan memiliki nilai 0x000000000000.
Jika objek basis informasi manajemen dot11DesiredBSSType (MIB) diatur ke dot11_BSS_type_independent, stasiun 802.11 harus menambahkan atau menghapus kunci dengan cara berikut:
Jika nilai anggota ini 0x000000000000, stasiun 802.11 menambahkan atau menghapus kunci dari tabel kunci default. Ketika NIC berada dalam mode OP Extensible Access Point (ExtAP), nilai ini adalah nol.
Jika nilai anggota ini adalah alamat MAC unicast yang valid, stasiun 802.11 menambahkan atau menghapus kunci dari tabel kunci default per stasiun untuk stasiun serekan dalam jaringan BSS independen (IBSS) dengan alamat MAC yang sama dengan nilai MacAddr .
Jika tabel kunci default per stasiun tidak ada untuk nilai MacAddr, stasiun 802.11 harus menggunakan tabel kunci default per stasiun yang tidak digunakan.
Untuk informasi selengkapnya tentang objek DOT11DesiredBSSType MIB, lihat OID_DOT11_DESIRED_BSS_TYPE.
bDelete
Nilai Boolean yang menentukan apakah driver miniport harus menghapus kunci default.
Jika diatur ke TRUE, driver miniport harus menghapus kunci default yang dirujuk oleh uKeyIndex. Jika diatur ke FALSE, driver miniport harus menambahkan atau memperbarui kunci default yang dirujuk oleh uKeyIndex .
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:
- Memutuskan sambungan dari jaringan set layanan dasar (BSS).
- Menjelajah ke jaringan BSS baru.
- Menyambungkan 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_DEFAULT_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 struktur DOT11_KEY_ALGO_TKIP_MIC .
Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_CCMP, array ucKey menentukan materi kunci melalui struktur DOT11_KEY_ALGO_CCMP .
Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_BIP, array ucKey menentukan materi kunci melalui struktur DOT11_KEY_ALGO_BIP .
ucKey[1]
Bahan utama.
Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_TKIP, array ucKey menentukan materi kunci melalui struktur DOT11_KEY_ALGO_TKIP_MIC .
Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_CCMP, array ucKey menentukan materi kunci melalui struktur DOT11_KEY_ALGO_CCMP .
Jika AlgorithmId diatur ke DOT11_CIPHER_ALGO_BIP, array ucKey menentukan materi kunci melalui struktur DOT11_KEY_ALGO_BIP .
Keterangan
Jika anggota bDeleteTRUE, anggota berikut tidak valid dan harus diabaikan:
- bStatic
- usKeyLength
- ucKey
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dalam versi Windows 8 dan yang lebih baru dari sistem operasi Windows. |
| Header | windot11.h (termasuk Ndis.h) |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk