Bagikan melalui

struktur ONEX_CONNECTION_PROFILE

  • Artikel

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

Tentang Arsitektur ACM

Skema OneX

Elemen authMode (OneX)

Elemen authPeriod (OneX)

elemen heldPeriod (OneX)

maxAuthFailures (OneX)

Elemen maxStart (OneX)

Elemen startPeriod (OneX)

Elemen supplicantMode (OneX)

Elemen userBasedVirtualLan (singleSignOn)

ONEX_AUTH_PARAMS

ONEX_NOTIFICATION_TYPE

ONEX_RESULT_UPDATE_DATA

Elemen Skema OneX

ONEX_VARIABLE_BLOB

WLAN_NOTIFICATION_DATA

WlanRegisterNotification