enumerasi ONEX_REASON_CODE (dot1x.h)

Artikel
08/23/2023

Jenis ONEX_REASON_CODE yang dijumlahkan menentukan kemungkinan nilai yang menunjukkan alasan autentikasi 802.1X gagal.

Sintaks

typedef enum _ONEX_REASON_CODE {
  ONEX_REASON_CODE_SUCCESS = 0,
  ONEX_REASON_START,
  ONEX_UNABLE_TO_IDENTIFY_USER,
  ONEX_IDENTITY_NOT_FOUND,
  ONEX_UI_DISABLED,
  ONEX_UI_FAILURE,
  ONEX_EAP_FAILURE_RECEIVED,
  ONEX_AUTHENTICATOR_NO_LONGER_PRESENT,
  ONEX_NO_RESPONSE_TO_IDENTITY,
  ONEX_PROFILE_VERSION_NOT_SUPPORTED,
  ONEX_PROFILE_INVALID_LENGTH,
  ONEX_PROFILE_DISALLOWED_EAP_TYPE,
  ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG,
  ONEX_PROFILE_INVALID_ONEX_FLAGS,
  ONEX_PROFILE_INVALID_TIMER_VALUE,
  ONEX_PROFILE_INVALID_SUPPLICANT_MODE,
  ONEX_PROFILE_INVALID_AUTH_MODE,
  ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES,
  ONEX_UI_CANCELLED,
  ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS,
  ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS,
  ONEX_UI_NOT_PERMITTED
} ONEX_REASON_CODE, PONEX_REASON_CODE;

Konstanta


`ONEX_REASON_CODE_SUCCESS` Nilai: 0 Menunjukkan autentikasi 802.1X berhasil.
`ONEX_REASON_START` Menunjukkan awal rentang yang menentukan nilai yang mungkin untuk kode alasan 802.1X.
`ONEX_UNABLE_TO_IDENTIFY_USER` Modul 802.1X tidak dapat mengidentifikasi serangkaian kredensial yang akan digunakan. Contohnya adalah ketika mode autentikasi diatur ke pengguna, tetapi tidak ada pengguna yang masuk.
`ONEX_IDENTITY_NOT_FOUND` Modul EAP tidak dapat memperoleh identitas untuk pengguna. Dengan demikian nilai saat ini tidak digunakan. Semua kesalahan khusus EAP dikembalikan sebagai ONEX_EAP_FAILURE_RECEIVED.
`ONEX_UI_DISABLED` Untuk melanjutkan autentikasi 802.1X, sistem perlu meminta input pengguna, tetapi antarmuka pengguna dinonaktifkan. Pada Windows Vista dan pada Windows Server 2008, nilai ini dapat dikembalikan jika metode EAP meminta input pengguna untuk profil untuk autentikasi Tamu atau komputer lokal. Pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal, nilai ini tidak boleh dikembalikan.
`ONEX_UI_FAILURE` Modul autentikasi 802.1X tidak dapat mengembalikan input pengguna yang diminta. Pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal, nilai ini dapat dikembalikan jika metode EAP meminta input pengguna, tetapi UI tidak dapat ditampilkan (ikon jaringan dikonfigurasi untuk tidak ditampilkan di taskbar, misalnya).
`ONEX_EAP_FAILURE_RECEIVED` Modul EAP mengembalikan kode kesalahan. Struktur ONEX_EAP_ERROR mungkin berisi informasi tambahan tentang kesalahan EAP tertentu (sertifikat tidak ditemukan, misalnya).
`ONEX_AUTHENTICATOR_NO_LONGER_PRESENT` Peer yang modul 802.1X sedang bernegosiasi tidak lagi ada atau tidak merespons (klien laptop bergerak di luar jangkauan titik akses nirkabel, misalnya).
`ONEX_NO_RESPONSE_TO_IDENTITY` Tidak ada respons yang diterima ke paket respons identitas EAP. Nilai ini menunjukkan masalah dengan infrastruktur (tautan antara titik akses nirkabel dan server autentikasi tidak berfungsi, misalnya).
`ONEX_PROFILE_VERSION_NOT_SUPPORTED` Modul 802.1X tidak mendukung versi profil ini.
`ONEX_PROFILE_INVALID_LENGTH` Anggota panjang yang ditentukan dalam profil 802.1X tidak valid.
`ONEX_PROFILE_DISALLOWED_EAP_TYPE` Jenis EAP yang ditentukan dalam profil 802.1X tidak diizinkan untuk media ini. Contohnya adalah ketika algoritma MD5 kunci digunakan untuk transmisi nirkabel.
`ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG` Jenis EAP atau bendera EAP yang ditentukan dalam profil 802.1X tidak valid. Contohnya adalah ketika jenis EAP tidak diinstal pada sistem.
`ONEX_PROFILE_INVALID_ONEX_FLAGS` Bendera 802.1X yang ditentukan dalam profil 802.1X tidak valid.
`ONEX_PROFILE_INVALID_TIMER_VALUE` Satu atau beberapa nilai timer yang ditentukan dalam profil 802.1X berada di luar rentang yang valid.
`ONEX_PROFILE_INVALID_SUPPLICANT_MODE` Mode pemohon yang ditentukan dalam profil 802.1X tidak valid.
`ONEX_PROFILE_INVALID_AUTH_MODE` Mode autentikasi yang ditentukan dalam profil 802.1X tidak valid.
`ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES` Properti koneksi EAP yang ditentukan dalam profil 802.1X tidak valid.
`ONEX_UI_CANCELLED` Input pengguna dibatalkan. Nilai ini dapat dikembalikan jika metode EAP meminta input pengguna, tetapi pengguna menekan tombol Batalkan atau menutup dialog input pengguna. Nilai ini didukung pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.
`ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS` Kredensial pengguna yang disimpan tidak valid. Nilai ini dapat dikembalikan jika profil disimpan dengan kredensial yang buruk (misalnya kata sandi yang salah), karena kredensial tidak diuji sampai profil benar-benar digunakan untuk membuat koneksi. Nilai ini didukung pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.
`ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS` Kredensial pengguna yang disimpan telah kedaluwarsa. Nilai ini dapat dikembalikan jika profil disimpan dengan kredensial dan kredensial kemudian kedaluwarsa (kedaluwarsa kata sandi setelah beberapa periode waktu, misalnya). Nilai ini didukung pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.
`ONEX_UI_NOT_PERMITTED` Antarmuka pengguna tidak diizinkan. Pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal, nilai ini dapat dikembalikan jika metode EAP meminta input pengguna dan profil dikonfigurasi dengan kredensial pengguna yang disimpan oleh pengguna lain dan bukan pengguna yang saat ini masuk. Nilai ini didukung pada Windows 7 dan pada Windows Server 2008 R2 dengan Layanan LAN Nirkabel terinstal.

Keterangan

Jenis enumerasi ONEX_REASON_CODE digunakan oleh modul 802.1X, komponen konfigurasi nirkabel baru yang didukung pada Windows Vista dan yang lebih baru.

ONEX_RESULT_UPDATE_DATA berisi informasi tentang perubahan status menjadi autentikasi 802.1X. Struktur ONEX_RESULT_UPDATE_DATA dikembalikan ketika anggota NotificationSource dari struktur WLAN_NOTIFICATION_DATAWLAN_NOTIFICATION_SOURCE_ONEX dan anggota NotificationCode dari struktur WLAN_NOTIFICATION_DATA untuk pemberitahuan yang diterima adalah OneXNotificationTypeResultUpdate. Untuk pemberitahuan ini, anggota pData dari struktur WLAN_NOTIFICATION_DATA menunjuk ke struktur ONEX_RESULT_UPDATE_DATA yang berisi informasi tentang perubahan status autentikasi 802.1X.

Anggota oneXStatus dari struktur ONEX_RESULT_UPDATE_DATA berisi struktur ONEX_STATUS . Jika terjadi kesalahan selama autentikasi 802.1X, anggota dwReason dari struktur ONEX_STATUS ini berisi alasan kesalahan yang ditentukan sebagai nilai dari enumerasi ONEX_REASON_CODE .

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	dot1x.h