ONEX _ CONNECTION _ PROFILE-Struktur
Die ONEX _ CONNECTION _ PROFILE-Struktur enthält Informationen zum 802.1X-Verbindungsprofil, das derzeit für die 802.1X-Authentifizierung verwendet wird.
Syntax
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;
Member
-
dwVersion
-
Die Version dieser ONEX _ CONNECTION _ PROFILE-Struktur.
-
dwTotalLen
-
Die Länge dieser ONEX _ CONNECTION _ PROFILE-Struktur in Bytes.
-
fOneXSupplimultiFlags
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwOneXSuppli csvFlags-Member enthält.
-
fsupplilvMode
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im suppli csvMode-Member enthält.
-
modusthMode
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im authMode-Member enthält.
-
fHeldPeriod
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwHeldPeriod-Member enthält.
-
fAuthPeriod
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwAuthPeriod-Member enthält.
-
fStartPeriod
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwStartPeriod-Member enthält.
-
fMaxStart
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwMaxStart-Member enthält.
-
fMaxAuthFailures
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwMaxAuthFailures-Member enthält.
-
fNetworkAuthTimeout
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwNetworkAuthTimeout-Member enthält.
-
fAllowLogonDialogs
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im bAllowLogonDialogs-Member enthält.
-
fNetworkAuthWithUITimeout
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im dwNetworkAuthWithUITimeout-Member enthält.
-
fUserBasedVLan
-
Gibt an, ob die ONEX _ CONNECTION _ PROFILE-Struktur gültige Daten im bUserBasedVLan-Member enthält.
-
dwOneXSupplimultiFlags
-
Ein Satz von 802.1X-Flags, die im Profil vorhanden sein können. Diese Flags sind für die interne Verwendung durch das 802.1X-Authentifizierungsmodul reserviert.
-
suppli übermode
-
Das supplimultimode-Element im 802.1X-Schema, das die für EAPOL-Start Nachrichten verwendete Übertragungsmethode angibt. Weitere Informationen finden Sie unter dem supplimultiMode -Element (OneX) im 802.1X-Schema.
Wert Bedeutung - OneXSuppliproxyModeInhibitTransmission
- 0
EAPOL-Start Nachrichten werden nicht übertragen. Nur für Kabel-LAN-Profile gültig. - OneXSuppliproxyModeLearn
- 1
Der Client bestimmt basierend auf der Netzwerkfunktion, wann EAPOL-Start Pakete gesendet werden sollen. EAPOL-Start Nachrichten werden nur bei Bedarf gesendet. Nur für Kabel-LAN-Profile gültig. - OneXSuppliproxyModeCompliant
- 2
EAPOL-Start Nachrichten werden gemäß 802.1X übertragen. Gültig für Kabel- und WLAN-Profile. -
authMode
-
Das authMode-Element im 802.1X-Schema, das den Typ der für die 802.1X-Authentifizierung verwendeten Anmeldeinformationen angibt. Weitere Informationen finden Sie unter dem authMode -Element (OneX) im 802.1X-Schema.
Wert Bedeutung - OneXAuthModeMachineOrUser
- 0
Verwenden Sie Computer- oder Benutzeranmeldeinformationen. Wenn ein Benutzer angemeldet ist, werden die Anmeldeinformationen des Benutzers für die Authentifizierung verwendet. Wenn kein Benutzer angemeldet ist, werden Computeranmeldeinformationen verwendet. - OneXAuthModeMachineOnly
- 1
Verwenden Sie nur Computeranmeldeinformationen. - OneXAuthModeUserOnly
- 2
Verwenden Sie nur Benutzeranmeldeinformationen. - OneXAuthModeGuest
- 3
Verwenden Sie nur Gastanmeldeinformationen (leer). - OneXAuthModeUnspecified
- 4
Die zu verwendenden Anmeldeinformationen werden nicht angegeben. -
dwHeldPeriod
-
Das heldPeriod-Element im 802.1X-Schema, das die Zeitspanne in Sekunden angibt, in der ein Client die Authentifizierung nach einem fehlgeschlagenen Authentifizierungsversuch nicht erneut versucht. Weitere Informationen finden Sie unter dem heldPeriod (OneX)-Element im 802.1X-Schema.
-
dwAuthPeriod
-
Das authPeriod-Element im 802.1X-Schema, das die maximale Zeitdauer in Sekunden angibt, in der ein Client auf eine Antwort vom Authentifikator wartet. Wenn innerhalb des angegebenen Zeitraums keine Antwort empfangen wird, geht der Client davon aus, dass im Netzwerk kein Authentifikator vorhanden ist. Weitere Informationen finden Sie unter dem authPeriod (OneX)-Element im 802.1X-Schema.
-
dwStartPeriod
-
Das startPeriod-Element im 802.1X-Schema, das die Zeitspanne in Sekunden angibt, die gewartet werden soll, bevor ein EAPOL-Start gesendet wird. Eine EAPOL-Start Nachricht wird gesendet, um den 802.1X-Authentifizierungsprozess zu starten. Weitere Informationen finden Sie unter dem element startPeriod (OneX) im 802.1X-Schema.
-
dwMaxStart
-
Das maxStart-Element im 802.1X-Schema, das die maximale Anzahl der gesendeten EAPOL-Start Nachrichten angibt. Nachdem die maximale Anzahl von EAPOL-Start Nachrichten gesendet wurde, geht der Client davon aus, dass im Netzwerk kein Authentifikator vorhanden ist. Weitere Informationen finden Sie unter dem maxStart (OneX)-Element im 802.1X-Schema.
-
dwMaxAuthFailures
-
Das maxAuthFailures-Element im 802.1X-Schema, das die maximale Anzahl von Authentifizierungsfehlern angibt, die für einen Satz von Anmeldeinformationen zulässig sind. Weitere Informationen finden Sie im MaxAuthFailures -Element (OneX) im 802.1X-Schema.
-
dwNetworkAuthTimeout
-
Die Zeit in Sekunden, die auf den Abschluss der 802.1X-Authentifizierung gewartet werden soll, bevor die normale Anmeldung fortgesetzt wird. Dieser Wert wird in Szenarien mit einmaligem Anmelden (Single Signon, SSO) verwendet. Dieser Wert ist in einem 802.1X-Profil standardmäßig auf 10 Sekunden eingestellt. Weitere Informationen finden Sie unter dem maxDelay (singleSignOn)-Element im 802.1X-Schema.
-
dwNetworkAuthWithUITimeout
-
Die maximale Dauer in Sekunden für das Warten auf eine Verbindung, falls während des einmaligen Anmeldens ein Dialogfeld für die Benutzeroberfläche angezeigt wird, für das Benutzereingaben erforderlich sind.
Auf Windows Vista mit SP1 und höher ist dieser Wert auf 10 Minuten hartcodiert und kann nicht konfiguriert werden. Bei Windows Vista Release to Manufacturing beträgt dieser Wert standardmäßig 60 Sekunden in einem 802.1X-Profil und wurde vom maxDelayWithAdditionalDialogs-Element im Schema gesteuert.
Auf Windows Vista mit SP1 und höher wird das maxDelayWithAdditionalDialogs-Element im 802.1X-Schema ignoriert und veraltet.
-
bAllowLogonDialogs
-
Ein -Wert, der angibt, ob EAP-Dialoge angezeigt werden sollen, wenn einmaliges Anmelden vor der Anmeldung verwendet wird. Weitere Informationen finden Sie unter dem allowAdditionalDialogs-Element im 802.1X-Schema.
-
bUserBasedVLan
-
Das userBasedVirtualLan-Element im 802.1X-Schema, das angibt, ob sich das vom Gerät verwendete virtuelle LAN (VLAN) basierend auf den Anmeldeinformationen des Benutzers ändert. Einige NAS-Geräte (Network Access Server) ändern das VLAN, nachdem sich ein Benutzer authentifiziert hat. Wenn userBasedVirtualLan true ist, kann der NAS das VLAN eines Geräts ändern, nachdem sich ein Benutzer authentifiziert hat. Weitere Informationen finden Sie unter dem userBasedVirtualLan-Element (singleSignOn) im 802.1X-Schema.
Hinweise
Die ONEX _ CONNECTION _ PROFILE-Struktur wird vom 802.1X-Modul verwendet, einer neuen Drahtlosen Konfigurationskomponente, die unter Windows Vista und höher unterstützt wird.
ONEX _ RESULT UPDATE _ _ DATA enthält Informationen zu einer Statusänderung in die 802.1X-Authentifizierung. Die ONEX _ RESULT UPDATE _ _ DATA-Struktur wird zurückgegeben, wenn das NotificationSource-Mitglied der WLAN NOTIFICATION _ _ DATA-Struktur WLAN NOTIFICATION SOURCE _ _ _ ONEX und das NotificationCode-Member der WLAN NOTIFICATION _ _ DATA-Struktur für die empfangene Benachrichtigung OneXNotificationTypeResultUpdate ist. Für diese Benachrichtigung verweist das pData-Element der WLAN NOTIFICATION _ _ DATA-Struktur auf eine ONEX RESULT UPDATE _ _ _ DATA-Struktur, die Informationen zur Änderung des 802.1X-Authentifizierungsstatus enthält.
Wenn das fOneXAuthParams-Member in der ONEX _ RESULT UPDATE _ _ DATA-Struktur festgelegt ist, enthält das authParams-Member der ONEX RESULT UPDATE _ _ _ DATA-Struktur eine ONEX _ _ VARIABLE-BLOB-Struktur mit einer ONEX _ _ AUTH-PARAMS-Struktur, die ab dem dwOffset-Member des ONEX _ VARIABLE-BLOB eingebettet _ wird. Das oneXConnProfile-Element der ONEX _ _ AUTH-PARAMS-Struktur enthält eine ONEX _ _ VARIABLE-BLOB-Struktur mit einer ONEX _ CONNECTION _ PROFILE-Struktur, die ab dem dwOffset-Element des ONEX VARIABLE BLOB eingebettet _ _ ist.
Die ONEX _ CONNECTION _ PROFILE-Struktur ist nicht in einer öffentlichen Headerdatei definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Nur [ Vista-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2008-Desktop-Apps] |