ONEX_REASON_CODE-Enumeration (dot1x.h)
Der ONEX_REASON_CODE enumerierte Typ gibt die möglichen Werte an, die den Grund für einen Fehler bei der 802.1X-Authentifizierung angeben.
Syntax
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;
Konstanten
ONEX_REASON_CODE_SUCCESS Wert: 0 Gibt an, dass die 802.1X-Authentifizierung erfolgreich war. |
ONEX_REASON_START Gibt den Anfang des Bereichs an, der die möglichen Werte für den 802.1X-Grundcode angibt. |
ONEX_UNABLE_TO_IDENTIFY_USER Das 802.1X-Modul konnte keinen Satz von Anmeldeinformationen identifizieren, die verwendet werden sollen. Ein Beispiel ist, wenn der Authentifizierungsmodus auf Benutzer festgelegt ist, aber kein Benutzer angemeldet ist. |
ONEX_IDENTITY_NOT_FOUND Das EAP-Modul konnte keine Identität für den Benutzer abrufen. Daher wird der Wert derzeit nicht verwendet. Alle EAP-spezifischen Fehler werden als ONEX_EAP_FAILURE_RECEIVED zurückgegeben. |
ONEX_UI_DISABLED Um mit der 802.1X-Authentifizierung fortzufahren, muss das System Benutzereingaben anfordern, aber die Benutzeroberfläche ist deaktiviert. Unter Windows Vista und Windows Server 2008 kann dieser Wert zurückgegeben werden, wenn eine EAP-Methode eine Benutzereingabe für ein Profil für die Gast- oder lokale Computerauthentifizierung angefordert hat. Unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst sollte dieser Wert nicht zurückgegeben werden. |
ONEX_UI_FAILURE Das Authentifizierungsmodul 802.1X konnte die angeforderte Benutzereingabe nicht zurückgeben. Unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst kann dieser Wert zurückgegeben werden, wenn eine EAP-Methode eine Benutzereingabe angefordert hat, die Benutzeroberfläche jedoch nicht angezeigt werden konnte (das Netzwerksymbol wurde beispielsweise so konfiguriert, dass es nicht in der Taskleiste angezeigt wird). |
ONEX_EAP_FAILURE_RECEIVED Das EAP-Modul hat einen Fehlercode zurückgegeben. Die ONEX_EAP_ERROR-Struktur kann zusätzliche Informationen zum spezifischen EAP-Fehler enthalten (z. B. ein Zertifikat nicht gefunden). |
ONEX_AUTHENTICATOR_NO_LONGER_PRESENT Der Peer, mit dem das 802.1X-Modul verhandelt hat, ist nicht mehr vorhanden oder reagiert nicht (ein Laptopclient wurde z. B. aus dem Bereich des Drahtlosen Zugriffspunkts verschoben). |
ONEX_NO_RESPONSE_TO_IDENTITY Es wurde keine Antwort auf ein EAP-Identitätsantwortpaket empfangen. Dieser Wert gibt ein Problem mit der Infrastruktur an (z. B. eine Verbindung zwischen dem Drahtlosen Zugriffspunkt und dem Authentifizierungsserver funktioniert nicht). |
ONEX_PROFILE_VERSION_NOT_SUPPORTED Diese Version des Profils wird vom Modul 802.1X nicht unterstützt. |
ONEX_PROFILE_INVALID_LENGTH Der im Profil 802.1X angegebene Längenelement ist ungültig. |
ONEX_PROFILE_DISALLOWED_EAP_TYPE Der im Profil 802.1X angegebene EAP-Typ ist für diese Medien nicht zulässig. Ein Beispiel ist, wenn der schlüsselierte MD5-Algorithmus für die drahtlose Übertragung verwendet wird. |
ONEX_PROFILE_INVALID_EAP_TYPE_OR_FLAG Der EAP-Typ oder die EAP-Flags, die im Profil 802.1X angegeben sind, sind ungültig. Ein Beispiel ist, wenn der EAP-Typ nicht auf dem System installiert ist. |
ONEX_PROFILE_INVALID_ONEX_FLAGS Die im 802.1X-Profil angegebenen 802.1X-Flags sind ungültig. |
ONEX_PROFILE_INVALID_TIMER_VALUE Mindestens ein im 802.1X-Profil angegebener Timerwert liegt außerhalb des gültigen Bereichs. |
ONEX_PROFILE_INVALID_SUPPLICANT_MODE Der im 802.1X-Profil angegebene supplicant-Modus ist ungültig. |
ONEX_PROFILE_INVALID_AUTH_MODE Der im Profil 802.1X angegebene Authentifizierungsmodus ist ungültig. |
ONEX_PROFILE_INVALID_EAP_CONNECTION_PROPERTIES Die im Profil 802.1X angegebenen EAP-Verbindungseigenschaften sind ungültig. |
ONEX_UI_CANCELLED Die Benutzereingabe wurde abgebrochen. Dieser Wert kann zurückgegeben werden, wenn eine EAP-Methode eine Benutzereingabe angefordert hat, der Benutzer jedoch die Schaltfläche Abbrechen gedrückt oder das Benutzereingabedialogfeld verworfen hat. Dieser Wert wird unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst unterstützt. |
ONEX_PROFILE_INVALID_EXPLICIT_CREDENTIALS Die gespeicherten Benutzeranmeldeinformationen sind ungültig. Dieser Wert kann zurückgegeben werden, wenn ein Profil mit ungültigen Anmeldeinformationen (z. B. einem falschen Kennwort) gespeichert wurde, da die Anmeldeinformationen erst getestet werden, wenn das Profil tatsächlich zum Herstellen einer Verbindung verwendet wird. Dieser Wert wird unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst unterstützt. |
ONEX_PROFILE_EXPIRED_EXPLICIT_CREDENTIALS Die gespeicherten Benutzeranmeldeinformationen sind abgelaufen. Dieser Wert kann zurückgegeben werden, wenn ein Profil mit Anmeldeinformationen gespeichert wurde und die Anmeldeinformationen anschließend abgelaufen sind (z. B. Kennwortablauf nach einem bestimmten Zeitraum). Dieser Wert wird unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst unterstützt. |
ONEX_UI_NOT_PERMITTED Die Benutzeroberfläche ist nicht zulässig. Unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst kann dieser Wert zurückgegeben werden, wenn eine EAP-Methode eine Benutzereingabe angefordert hat und das Profil mit Benutzeranmeldeinformationen konfiguriert ist, die von einem anderen Benutzer und nicht vom aktuell angemeldeten Benutzer gespeichert wurden. Dieser Wert wird unter Windows 7 und Windows Server 2008 R2 mit installiertem WLAN-Dienst unterstützt. |
Hinweise
Der ONEX_REASON_CODE enumerierte Typ wird vom 802.1X-Modul verwendet, einer neuen drahtlosen Konfigurationskomponente, die unter Windows Vista und höher unterstützt wird.
Die 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-Element der WLAN_NOTIFICATION_DATA-StrukturWLAN_NOTIFICATION_SOURCE_ONEX und das NotificationCode-Element 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 der 802.1X-Authentifizierung status enthält.
Das oneXStatus-Element der ONEX_RESULT_UPDATE_DATA-Struktur enthält eine ONEX_STATUS-Struktur . Wenn während der 802.1X-Authentifizierung ein Fehler aufgetreten ist, enthält das dwReason-Element dieser ONEX_STATUS-Struktur den Grund für den Fehler, der als Wert aus der ONEX_REASON_CODE-Enumeration angegeben ist.
Anforderungen
Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
Kopfzeile | dot1x.h |