Compartilhar via


estrutura ONEX_AUTH_PARAMS (dot1x.h)

A estrutura ONEX_AUTH_PARAMS contém parâmetros de autenticação 802.1X usados para autenticação 802.1X.

Sintaxe

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;

Membros

fUpdatePending

Indica se uma atualização status está pendente para autenticação 802.X.

oneXConnProfile

O perfil de conexão de autenticação 802.1X. Esse membro contém uma estrutura de ONEX_CONNECTION_PROFILE inserida começando no membro dwOffset do ONEX_VARIABLE_BLOB.

authIdentity

A identidade usada para autenticação 802.1X status. Esse membro é um valor da enumeração ONEX_AUTH_IDENTITY .

dwQuarantineState

O valor do estado de isolamento de quarentena do computador local. O estado de isolamento determina sua conectividade de rede. Esse membro corresponde a um valor da enumeração EAPHost ISOLATION_STATE .

fSessionId

Indica se a estrutura ONEX_AUTH_PARAMS contém uma ID de sessão no membro dwSessionId .

fhUserToken

Indica se a estrutura ONEX_AUTH_PARAMS contém um identificador de token de usuário no membro hUserToken .

Por motivos de segurança, o membro hUserToken da estrutura ONEX_AUTH_PARAMS retornado no membro authParams da estrutura ONEX_RESULT_UPDATE_DATA é sempre definido como NULL.

fOnexUserProfile

Indica se a estrutura ONEX_AUTH_PARAMS contém um perfil de usuário 802.1X no membro OneXUserProfile .

Por motivos de segurança, o membro OneXUserProfile da estrutura ONEX_AUTH_PARAMS retornado no membro authParams da estrutura ONEX_RESULT_UPDATE_DATA sempre é definido como NULL.

fIdentity

Indica se a estrutura ONEX_AUTH_PARAMS contém uma identidade 802.1X no membro Identity .

fUserName

Indica se a estrutura ONEX_AUTH_PARAMS contém um nome de usuário usado para autenticação 802.1X no membro UserName .

fDomain

Indica se a estrutura ONEX_AUTH_PARAMS contém um domínio usado para autenticação 802.1X no membro Domain .

dwSessionId

A ID da sessão do usuário atualmente conectado ao console. Esse membro corresponde ao valor retornado pela função WTSGetActiveConsoleSessionId . Esse membro conterá uma ID de sessão se o membro bitfield fSessionId estiver definido.

hUserToken

O identificador de token de usuário usado para autenticação 802.1X. Esse membro conterá um identificador de token de usuário se o membro do campo de bits fhUserToken estiver definido.

Por motivos de segurança, o membro hUserToken da estrutura ONEX_AUTH_PARAMS retornado no membro authParams da estrutura ONEX_RESULT_UPDATE_DATA é sempre definido como NULL.

OneXUserProfile

O perfil de usuário 802.1X usado para autenticação 802.1X. Esse membro contém um perfil de usuário inserido começando no membro dwOffset do ONEX_VARIABLE_BLOB se o membro do campo de bits fOneXUserProfile estiver definido.

Por motivos de segurança, o membro OneXUserProfile da estrutura ONEX_AUTH_PARAMS retornado no membro authParams da estrutura ONEX_RESULT_UPDATE_DATA sempre é definido como NULL.

Identity

A identidade 802.1X usada para autenticação 802.1X. Esse membro contém uma cadeia de caracteres Unicode terminada em NULL com a identidade começando no membro dwOffset do ONEX_VARIABLE_BLOB se o membro do campo de bits fIdentity estiver definido.

UserName

O nome de usuário usado para autenticação 802.1X. Esse membro contém uma cadeia de caracteres Unicode terminada em NULL com o nome de usuário começando no membro dwOffset do ONEX_VARIABLE_BLOB se o membro do campo de bits fUserName estiver definido.

Domain

O domínio usado para autenticação 802.1X. Esse membro contém uma cadeia de caracteres Unicode terminada em NULL com o domínio começando no membro dwOffset do ONEX_VARIABLE_BLOB se o membro do campo de bits fDomain estiver definido.

Comentários

A estrutura ONEX_AUTH_PARAMS é usada pelo módulo 802.1X, um novo componente de configuração sem fio com suporte no Windows Vista e posterior.

O ONEX_RESULT_UPDATE_DATA contém informações sobre uma status alteração para autenticação 802.1X. A estrutura ONEX_RESULT_UPDATE_DATA é retornada quando o membro NotificationSource da estrutura WLAN_NOTIFICATION_DATA é WLAN_NOTIFICATION_SOURCE_ONEX e o membro NotificationCode da estrutura WLAN_NOTIFICATION_DATA para notificação recebida é OneXNotificationTypeResultUpdate. Para essa notificação, o membro pData da estrutura WLAN_NOTIFICATION_DATA aponta para uma estrutura ONEX_RESULT_UPDATE_DATA que contém informações sobre a alteração de status de autenticação 802.1X.

Se o membro fOneXAuthParams na estrutura ONEX_RESULT_UPDATE_DATA estiver definido, o membro authParams da estrutura ONEX_RESULT_UPDATE_DATA conterá uma estrutura ONEX_VARIABLE_BLOB com uma estrutura ONEX_AUTH_PARAMS inserida começando no membro dwOffset do ONEX_VARIABLE_BLOB.

Por motivos de segurança, os membros hUserToken e OneXUserProfile da estrutura ONEX_AUTH_PARAMSretornados no membro authParams são sempre definidos como NULL.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho dot1x.h

Confira também

Sobre a arquitetura do ACM

ISOLATION_STATE

ONEX_AUTH_IDENTITY

ONEX_EAP_ERROR

ONEX_NOTIFICATION_TYPE

ONEX_RESULT_UPDATE_DATA

ONEX_VARIABLE_BLOB

WLAN_NOTIFICATION_DATA

WTSGetActiveConsoleSessionId

WlanRegisterNotification