ONEX_AUTH_PARAMS-Struktur (dot1x.h)
Die ONEX_AUTH_PARAMS-Struktur enthält 802.1X-Authentifizierungsparameter, die für die 802.1X-Authentifizierung verwendet werden.
Syntax
typedef struct _ONEX_AUTH_PARAMS {
BOOL fUpdatePending;
ONEX_VARIABLE_BLOB oneXConnProfile;
ONEX_AUTH_IDENTITY authIdentity;
DWORD dwQuarantineState;
DWORD fSessionId : 1;
DWORD fhUserToken : 1;
DWORD fOnexUserProfile : 1;
DWORD fIdentity : 1;
DWORD fUserName : 1;
DWORD fDomain : 1;
DWORD dwSessionId;
HANDLE hUserToken;
ONEX_VARIABLE_BLOB OneXUserProfile;
ONEX_VARIABLE_BLOB Identity;
ONEX_VARIABLE_BLOB UserName;
ONEX_VARIABLE_BLOB Domain;
} ONEX_AUTH_PARAMS, *PONEX_AUTH_PARAMS;
Member
fUpdatePending
Gibt an, ob ein status Update für die 802.X-Authentifizierung aussteht.
oneXConnProfile
Das 802.1X-Authentifizierungsverbindungsprofil. Dieses Element enthält eine eingebettete ONEX_CONNECTION_PROFILE-Struktur ab dem dwOffset-Element des ONEX_VARIABLE_BLOB.
authIdentity
Die Identität, die für die 802.1X-Authentifizierung verwendet wird, status. Dieser Member ist ein Wert aus der ONEX_AUTH_IDENTITY-Enumeration .
dwQuarantineState
Der Isolationsstatuswert des lokalen Computers. Der Isolationszustand bestimmt die Netzwerkkonnektivität. Dieses Element entspricht einem Wert aus der EAPHost-ISOLATION_STATE-Enumeration .
fSessionId
Gibt an, ob die ONEX_AUTH_PARAMS-Struktur eine Sitzungs-ID im dwSessionId-Element enthält.
fhUserToken
Gibt an, ob die ONEX_AUTH_PARAMS-Struktur ein Benutzertokenhandle im hUserToken-Element enthält.
Aus Sicherheitsgründen ist das hUserToken-Element der ONEX_AUTH_PARAMS-Struktur , das im authParams-Member der ONEX_RESULT_UPDATE_DATA-Struktur zurückgegeben wird, immer auf NULL festgelegt.
fOnexUserProfile
Gibt an, ob die ONEX_AUTH_PARAMS-Struktur ein 802.1X-Benutzerprofil im OneXUserProfile-Element enthält.
Aus Sicherheitsgründen ist das OneXUserProfile-Element der ONEX_AUTH_PARAMS-Struktur , das im authParams-Member der ONEX_RESULT_UPDATE_DATA-Struktur zurückgegeben wird, immer auf NULL festgelegt.
fIdentity
Gibt an, ob die ONEX_AUTH_PARAMS-Struktur eine 802.1X-Identität im Identitätselement enthält.
fUserName
Gibt an, ob die ONEX_AUTH_PARAMS-Struktur einen Benutzernamen enthält, der für die 802.1X-Authentifizierung im UserName-Member verwendet wird.
fDomain
Gibt an, ob die ONEX_AUTH_PARAMS-Struktur eine Domäne enthält, die für die 802.1X-Authentifizierung im Domänenmitglied verwendet wird.
dwSessionId
Die Sitzungs-ID des Benutzers, der sich derzeit bei der Konsole angemeldet hat. Dieser Member entspricht dem von der FUNKTION WTSGetActiveConsoleSessionId zurückgegebenen Wert. Dieses Element enthält eine Sitzungs-ID, wenn das fSessionId-Bitfeldelement festgelegt ist.
hUserToken
Das Benutzertokenhandle, das für die 802.1X-Authentifizierung verwendet wird. Dieses Element enthält ein Benutzertokenhandle, wenn das bitfeldelement fhUserToken festgelegt ist.
Aus Sicherheitsgründen ist das hUserToken-Element der ONEX_AUTH_PARAMS-Struktur , das im authParams-Member der ONEX_RESULT_UPDATE_DATA-Struktur zurückgegeben wird, immer auf NULL festgelegt.
OneXUserProfile
Das 802.1X-Benutzerprofil, das für die 802.1X-Authentifizierung verwendet wird. Dieses Element enthält ein eingebettetes Benutzerprofil ab dem dwOffset-Member des ONEX_VARIABLE_BLOB , wenn das fOneXUserProfile-Bitfeldelement festgelegt ist.
Aus Sicherheitsgründen ist das OneXUserProfile-Element der ONEX_AUTH_PARAMS-Struktur , das im authParams-Member der ONEX_RESULT_UPDATE_DATA-Struktur zurückgegeben wird, immer auf NULL festgelegt.
Identity
Die 802.1X-Identität, die für die 802.1X-Authentifizierung verwendet wird. Dieses Element enthält eine NULL-beendete Unicode-Zeichenfolge, deren Identität am dwOffset-Member des ONEX_VARIABLE_BLOB beginnt, wenn der fIdentity-Bitfeldmember festgelegt ist.
UserName
Der Benutzername, der für die 802.1X-Authentifizierung verwendet wird. Dieses Element enthält eine NULL-beendete Unicode-Zeichenfolge, deren Benutzername am dwOffset-Member des ONEX_VARIABLE_BLOB beginnt, wenn das fUserName-Bitfeldelement festgelegt ist.
Domain
Die Domäne, die für die 802.1X-Authentifizierung verwendet wird. Dieses Element enthält eine NULL-beendete Unicode-Zeichenfolge, wobei die Domäne am dwOffset-Member des ONEX_VARIABLE_BLOB beginnt, wenn der fDomain-Bitfeldmember festgelegt ist.
Hinweise
Die ONEX_AUTH_PARAMS-Struktur wird vom Modul 802.1X verwendet, einer neuen Komponente für die drahtlose Konfiguration, die unter Windows Vista und höher unterstützt wird.
Die ONEX_RESULT_UPDATE_DATA enthält Informationen zu einer status Änderung der 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 empfangene Benachrichtigungen OneXNotificationTypeResultUpdate ist. Für diese Benachrichtigung verweist das pData-Member der WLAN_NOTIFICATION_DATA-Struktur auf eine ONEX_RESULT_UPDATE_DATA-Struktur, die Informationen zur Änderung der Authentifizierung 802.1X status enthält.
Wenn das fOneXAuthParams-Element in der ONEX_RESULT_UPDATE_DATA-Struktur festgelegt ist, enthält das authParams-Element der ONEX_RESULT_UPDATE_DATA-Struktur eine ONEX_VARIABLE_BLOB-Struktur mit einer ONEX_AUTH_PARAMS Struktur, die ab dem dwOffset-Element des ONEX_VARIABLE_BLOB eingebettet ist.
Aus Sicherheitsgründen sind die hUserToken - und OneXUserProfile-Member der ONEX_AUTH_PARAMS-Struktur , die im authParams-Member zurückgegeben werden, immer auf NULL festgelegt.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | dot1x.h |
Weitere Informationen
Informationen zur ACM-Architektur
ONEX_EAP_ERROR