struktur ONEX_CONNECTION_PROFILE
Struktur ONEX_CONNECTION_PROFILE berisi informasi tentang profil koneksi 802.1X yang saat ini digunakan untuk autentikasi 802.1X.
Sintaks
typedef struct _ONEX_CONNECTION_PROFILE {
DWORD dwVersion;
DWORD dwTotalLen;
DWORD fOneXSupplicantFlags :1;
DWORD fsupplicantMode :1;
DWORD fauthMode :1;
DWORD fHeldPeriod :1;
DWORD fAuthPeriod :1;
DWORD fStartPeriod :1;
DWORD fMaxStart :1;
DWORD fMaxAuthFailures :1;
DWORD fNetworkAuthTimeout :1;
DWORD fAllowLogonDialogs :1;
DWORD fNetworkAuthWithUITimeout :1;
DWORD fUserBasedVLan :1;
DWORD dwOneXSupplicantFlags;
ONEX_SUPPLICANT_MODE supplicantMode;
ONEX_AUTH_MODE authMode;
DWORD dwHeldPeriod;
DWORD dwAuthPeriod;
DWORD dwStartPeriod;
DWORD dwMaxStart;
DWORD dwMaxAuthFailures;
DWORD dwNetworkAuthTimeout;
DWORD dwNetworkAuthWithUITimeout;
BOOL bAllowLogonDialogs;
BOOL bUserBasedVLan;
} ONEX_CONNECTION_PROFILE, *PONEX_CONNECTION_PROFILE;
Anggota
-
dwVersion
-
Versi struktur ONEX_CONNECTION_PROFILE ini.
-
dwTotalLen
-
Panjangnya, dalam byte, dari struktur ONEX_CONNECTION_PROFILE ini.
-
fOneXSupplicantFlags
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwOneXSupplicantFlags .
-
fsupplicantMode
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota supplicantMode .
-
fauthMode
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota authMode .
-
fHeldPeriod
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwHeldPeriod .
-
fAuthPeriod
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwAuthPeriod .
-
fStartPeriod
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwStartPeriod .
-
fMaxStart
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwMaxStart .
-
fMaxAuthFailures
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwMaxAuthFailures .
-
fNetworkAuthTimeout
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwNetworkAuthTimeout .
-
fAllowLogonDialogs
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota bAllowLogonDialogs .
-
fNetworkAuthWithUITimeout
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota dwNetworkAuthWithUITimeout .
-
fUserBasedVLan
-
Menunjukkan apakah struktur ONEX_CONNECTION_PROFILE berisi data yang valid di anggota bUserBasedVLan .
-
dwOneXSupplicantFlags
-
Satu set bendera 802.1X yang dapat ada di profil. Bendera ini disediakan untuk penggunaan internal oleh modul autentikasi 802.1X.
-
supplicantMode
-
Elemen supplicantMode dalam skema 802.1X yang menentukan metode transmisi yang digunakan untuk pesan EAPOL-Start. Untuk informasi selengkapnya, lihat Elemen supplicantMode (OneX) dalam skema 802.1X.
Nilai Makna - OneXSupplicantModeInhibitTransmission
- 0
EAPOL-Start pesan tidak ditransmisikan. Hanya berlaku untuk profil LAN berkabel. - OneXSupplicantModeLearn
- 1
Klien menentukan kapan harus mengirim paket EAPOL-Start berdasarkan kemampuan jaringan. EAPOL-Start pesan hanya dikirim jika diperlukan. Hanya berlaku untuk profil LAN berkabel. - OneXSupplicantModeCompliant
- 2
EAPOL-Start pesan dikirimkan sebagaimana ditentukan oleh 802.1X. Berlaku untuk profil LAN berkabel dan nirkabel. -
authMode
-
Elemen authMode dalam skema 802.1X yang menentukan jenis kredensial yang digunakan untuk autentikasi 802.1X. Untuk informasi selengkapnya, lihat Elemen authMode (OneX) dalam skema 802.1X.
Nilai Makna - OneXAuthModeMachineOrUser
- 0
Gunakan kredensial mesin atau pengguna. Saat pengguna masuk, kredensial pengguna digunakan untuk autentikasi. Ketika tidak ada pengguna yang masuk, kredensial komputer digunakan. - OneXAuthModeMachineOnly
- 1
Gunakan kredensial komputer saja. - OneXAuthModeUserOnly
- 2
Gunakan kredensial pengguna saja. - OneXAuthModeGuest
- 3
Gunakan kredensial tamu (kosong) saja. - OneXAuthModeUnspecified
- 4
Kredensial yang akan digunakan tidak ditentukan. -
dwHeldPeriod
-
Elemen heldPeriod dalam skema 802.1X yang menentukan lamanya waktu, dalam detik, di mana klien tidak akan mencoba kembali autentikasi setelah upaya autentikasi yang gagal. Untuk informasi selengkapnya, lihat Elemen heldPeriod (OneX) dalam skema 802.1X.
-
dwAuthPeriod
-
Elemen authPeriod dalam skema 802.1X yang menentukan panjang waktu maksimum, dalam detik, di mana klien menunggu respons dari pengautentikasi. Jika respons tidak diterima dalam periode yang ditentukan, klien mengasumsikan bahwa tidak ada pengautentikasi yang ada di jaringan. Untuk informasi selengkapnya, lihat Elemen authPeriod (OneX) dalam skema 802.1X.
-
dwStartPeriod
-
Elemen startPeriod dalam skema 802.1X yang menentukan lamanya waktu, dalam detik, untuk menunggu sebelum EAPOL-Start dikirim. Pesan EAPOL-Start dikirim untuk memulai proses autentikasi 802.1X. Untuk informasi selengkapnya, lihat Elemen startPeriod (OneX) dalam skema 802.1X.
-
dwMaxStart
-
Elemen maxStart dalam skema 802.1X yang menentukan jumlah maksimum pesan EAPOL-Start yang dikirim. Setelah jumlah maksimum pesan EAPOL-Start dikirim, klien mengasumsikan bahwa tidak ada pengautentikasi yang ada di jaringan. Untuk informasi selengkapnya, lihat MaxStart (OneX) Element dalam skema 802.1X.
-
dwMaxAuthFailures
-
Elemen maxAuthFailures dalam skema 802.1X yang menentukan jumlah maksimum kegagalan autentikasi yang diizinkan untuk serangkaian kredensial. Untuk informasi selengkapnya, lihat elemen maxAuthFailures (OneX) dalam skema 802.1X.
-
dwNetworkAuthTimeout
-
Waktu, dalam detik, untuk menunggu penyelesaian autentikasi 802.1X sebelum masuk normal berlangsung. Nilai ini digunakan dalam skenario akses menyeluruh (SSO). Nilai ini default ke 10 detik dalam profil 802.1X. Untuk informasi selengkapnya, lihat Elemen maxDelay (singleSignOn) dalam skema 802.1X.
-
dwNetworkAuthWithUITimeout
-
Waktu durasi maksimum, dalam detik, untuk menunggu koneksi jika kotak dialog antarmuka pengguna yang memerlukan input pengguna ditampilkan selama SSO per masuk.
Pada Windows Vista dengan SP1 dan yang lebih baru, nilai ini dikodekan secara permanen menjadi 10 menit dan tidak dapat dikonfigurasi. Pada Rilis Windows Vista ke Manufaktur, nilai ini default ke 60 detik dalam profil 802.1X dan dikendalikan oleh elemen maxDelayWithAdditionalDialogs dalam skema.
Pada Windows Vista dengan SP1 dan yang lebih baru, elemen maxDelayWithAdditionalDialogs dalam skema 802.1X diabaikan dan tidak digunakan lagi.
-
bAllowLogonDialogs
-
Nilai yang menentukan apakah akan mengizinkan dialog EAP ditampilkan saat menggunakan SSO pra-masuk. Untuk informasi selengkapnya, lihat elemen allowAdditionalDialogs dalam skema 802.1X.
-
bUserBasedVLan
-
Elemen userBasedVirtualLan dalam skema 802.1X yang menentukan apakah LAN virtual (VLAN) yang digunakan oleh perangkat berubah berdasarkan kredensial pengguna. Beberapa perangkat server akses jaringan (NAS) mengubah VLAN setelah pengguna mengautentikasi. Saat userBasedVirtualLan TRUE, NAS dapat mengubah VLAN perangkat setelah pengguna mengautentikasi. Untuk informasi selengkapnya, lihat Elemen userBasedVirtualLan (singleSignOn) dalam skema 802.1X.
Keterangan
Struktur ONEX_CONNECTION_PROFILE 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.
Jika anggota fOneXAuthParams dalam struktur ONEX_RESULT_UPDATE_DATA diatur, maka anggota authParams dari struktur ONEX_RESULT_UPDATE_DATA berisi struktur ONEX_VARIABLE_BLOB dengan struktur ONEX_AUTH_PARAMS yang disematkan mulai dari anggota dwOffsetdari ONEX_VARIABLE_BLOB. Anggota oneXConnProfile dari struktur ONEX_AUTH_PARAMS berisi struktur ONEX_VARIABLE_BLOB dengan struktur ONEX_CONNECTION_PROFILE yang disematkan mulai dari anggota dwOffsetdari ONEX_VARIABLE_BLOB.
Struktur ONEX_CONNECTION_PROFILE tidak ditentukan dalam file header publik.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2008 [hanya aplikasi desktop] |
Lihat juga