структура ONEX_AUTH_PARAMS (dot1x.h)

Статья
08/23/2023

Структура ONEX_AUTH_PARAMS содержит параметры проверки подлинности 802.1X, используемые для проверки подлинности 802.1X.

Синтаксис

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;

Члены

fUpdatePending

Указывает, ожидается ли обновление состояния для проверки подлинности 802.X.

oneXConnProfile

Профиль подключения проверки подлинности 802.1X. Этот элемент содержит внедренную ONEX_CONNECTION_PROFILE структуру, начиная с элемента dwOffsetONEX_VARIABLE_BLOB.

authIdentity

Удостоверение, используемое для состояния проверки подлинности 802.1X. Этот элемент является значением из перечисления ONEX_AUTH_IDENTITY .

dwQuarantineState

Значение состояния изоляции карантина локального компьютера. Состояние изоляции определяет сетевое подключение. Этот элемент соответствует значению из перечисления EAPHost ISOLATION_STATE .

fSessionId

Указывает, содержит ли структура ONEX_AUTH_PARAMS идентификатор сеанса в элементе dwSessionId .

fhUserToken

Указывает, содержит ли структура ONEX_AUTH_PARAMS дескриптор маркера пользователя в элементе hUserToken .

По соображениям безопасности член hUserTokenструктуры ONEX_AUTH_PARAMS , возвращаемой в элементе authParamsструктуры ONEX_RESULT_UPDATE_DATA , всегда имеет значение NULL.

fOnexUserProfile

Указывает, содержит ли структура ONEX_AUTH_PARAMS профиль пользователя 802.1X в элементе OneXUserProfile .

По соображениям безопасности для элемента OneXUserProfileструктуры ONEX_AUTH_PARAMS , возвращаемой в элементе authParamsструктуры ONEX_RESULT_UPDATE_DATA , всегда задано значение NULL.

fIdentity

Указывает, содержит ли структура ONEX_AUTH_PARAMS удостоверение 802.1X в элементе Identity .

fUserName

Указывает, содержит ли структура ONEX_AUTH_PARAMS имя пользователя, используемое для проверки подлинности 802.1X в элементе UserName .

fDomain

Указывает, содержит ли структура ONEX_AUTH_PARAMS домен, используемый для проверки подлинности 802.1X в члене домена .

dwSessionId

Идентификатор сеанса пользователя, вошедшего в консоль. Этот элемент соответствует значению, возвращаемому функцией WTSGetActiveConsoleSessionId . Этот элемент содержит идентификатор сеанса, если задан элемент bitfield fSessionId .

hUserToken

Дескриптор маркера пользователя, используемый для проверки подлинности 802.1X. Этот элемент содержит дескриптор маркера пользователя, если задан элемент bitfield fhUserToken .

OneXUserProfile

Профиль пользователя 802.1X, используемый для проверки подлинности 802.1X. Этот элемент содержит внедренный профиль пользователя, начиная с элемента dwOffsetONEX_VARIABLE_BLOB , если задан элемент bitfield fOneXUserProfile .

Identity

Удостоверение 802.1X, используемое для проверки подлинности 802.1X. Этот элемент содержит строку Юникода со значением NULL, начинающейся с члена dwOffsetONEX_VARIABLE_BLOB , если задан элемент bitfield fIdentity .

UserName

Имя пользователя, используемое для проверки подлинности 802.1X. Этот элемент содержит строку Юникода, завершаемую NULL, с именем пользователя, начинающегося с элемента dwOffsetONEX_VARIABLE_BLOB , если задан элемент bitfield fUserName .

Domain

Домен, используемый для проверки подлинности 802.1X. Этот элемент содержит строку Юникода, завершаемую null, с доменом, начинающейся с элемента dwOffsetONEX_VARIABLE_BLOB , если задан элемент bitfield fDomain .

ONEX_RESULT_UPDATE_DATA содержит сведения об изменении состояния на проверку подлинности 802.1X. Структура ONEX_RESULT_UPDATE_DATA возвращается, когда элемент NotificationSourceструктуры WLAN_NOTIFICATION_DATAWLAN_NOTIFICATION_SOURCE_ONEX , а элемент NotificationCodeструктуры WLAN_NOTIFICATION_DATA для полученного уведомления — OneXNotificationTypeResultUpdate. Для этого уведомления элемент pDataструктуры WLAN_NOTIFICATION_DATA указывает на структуру ONEX_RESULT_UPDATE_DATA , содержащую сведения об изменении состояния проверки подлинности 802.1X.

Если элемент fOneXAuthParams в структуре ONEX_RESULT_UPDATE_DATA задан, то элемент authParams структуры ONEX_RESULT_UPDATE_DATA содержит структуру ONEX_VARIABLE_BLOB с внедренной ONEX_AUTH_PARAMS структурой, начиная с элемента dwOffsetONEX_VARIABLE_BLOB.

По соображениям безопасности члены hUserToken и OneXUserProfile структуры ONEX_AUTH_PARAMS , возвращаемой в элементе authParams , всегда имеют значение NULL.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Верхняя часть	dot1x.h