ONEX_CONNECTION_PROFILE 구조체
ONEX_CONNECTION_PROFILE 구조에는 현재 802.1X 인증에 사용되는 802.1X 연결 프로필에 대한 정보가 포함되어 있습니다.
구문
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;
멤버
-
dwVersion
-
이 ONEX_CONNECTION_PROFILE 구조체의 버전입니다.
-
dwTotalLen
-
이 ONEX_CONNECTION_PROFILE 구조체의 길이(바이트)입니다.
-
fOneXSupplicantFlags
-
ONEX_CONNECTION_PROFILE 구조체에 dwOneXSupplicantFlags 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fsupplicantMode
-
ONEX_CONNECTION_PROFILE 구조체에 supplicantMode 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fauthMode
-
ONEX_CONNECTION_PROFILE 구조체에 authMode 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fHeldPeriod
-
ONEX_CONNECTION_PROFILE 구조체에 dwHeldPeriod 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fAuthPeriod
-
ONEX_CONNECTION_PROFILE 구조체에 dwAuthPeriod 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fStartPeriod
-
ONEX_CONNECTION_PROFILE 구조체에 dwStartPeriod 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fMaxStart
-
ONEX_CONNECTION_PROFILE 구조체에 dwMaxStart 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fMaxAuthFailures
-
ONEX_CONNECTION_PROFILE 구조체에 dwMaxAuthFailures 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fNetworkAuthTimeout
-
ONEX_CONNECTION_PROFILE 구조체에 dwNetworkAuthTimeout 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fAllowLogonDialogs
-
ONEX_CONNECTION_PROFILE 구조체에 bAllowLogonDialogs 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fNetworkAuthWithUITimeout
-
ONEX_CONNECTION_PROFILE 구조체에 dwNetworkAuthWithUITimeout 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
fUserBasedVLan
-
ONEX_CONNECTION_PROFILE 구조체에 bUserBasedVLan 멤버에 유효한 데이터가 포함되어 있는지를 나타냅니다.
-
dwOneXSupplicantFlags
-
프로필에 있을 수 있는 802.1X 플래그 집합입니다. 이러한 플래그는 802.1X 인증 모듈에서 내부적으로 사용하도록 예약되어 있습니다.
-
supplicantMode
-
EAPOL-Start 메시지에 사용되는 전송 방법을 지정하는 802.1X 스키마의 supplicantMode 요소입니다. 자세한 내용은 802.1X 체계의 supplicantMode(OneX) 요소를 참조하세요.
값 의미 - OneXSupplicantModeInhibitTransmission
- 0
EAPOL-Start 메시지는 전송되지 않습니다. 유선 LAN 프로필에만 유효합니다. - OneXSupplicantModeLearn
- 1
클라이언트는 네트워크 기능에 따라 EAPOL-Start 패킷을 보낼 시기를 결정합니다. EAPOL-Start 메시지는 필요한 경우에만 전송됩니다. 유선 LAN 프로필에만 유효합니다. - OneXSupplicantModeCompliant
- 2
EAPOL-Start 메시지는 802.1X에 지정된 대로 전송됩니다. 유선 및 무선 LAN 프로필 모두에 유효합니다. -
authMode
-
802.1X 인증에 사용되는 자격 증명 유형을 지정하는 802.1X 스키마의 authMode 요소입니다. 자세한 내용은 802.1X 스키마의 authMode(OneX) 요소를 참조하세요.
값 의미 - OneXAuthModeMachineOrUser
- 0
컴퓨터 또는 사용자 자격 증명을 사용합니다. 사용자가 로그온하면 사용자의 자격 증명이 인증에 사용됩니다. 로그온한 사용자가 없으면 컴퓨터 자격 증명이 사용됩니다. - OneXAuthModeMachineOnly
- 1
컴퓨터 자격 증명만 사용합니다. - OneXAuthModeUserOnly
- 2
사용자 자격 증명만 사용합니다. - OneXAuthModeGuest
- 3
게스트(빈) 자격 증명만 사용합니다. - OneXAuthModeUnspecified
- 4
사용할 자격 증명은 지정되지 않습니다. -
dwHeldPeriod
-
802.1X 스키마의 heldPeriod 요소로, 인증 시도 실패 후 클라이언트가 인증을 다시 시도하지 않는 시간(초)을 지정합니다. 자세한 내용은 802.1X 스키 마의 heldPeriod(OneX) 요소를 참조하세요.
-
dwAuthPeriod
-
클라이언트가 인증자의 응답을 기다리는 최대 시간(초)을 지정하는 802.1X 스키마의 authPeriod 요소입니다. 지정된 기간 내에 응답을 받지 못한 경우 클라이언트는 네트워크에 인증자가 없다고 가정합니다. 자세한 내용은 802.1X 스키 마의 authPeriod(OneX) 요소를 참조하세요.
-
dwStartPeriod
-
EAPOL-Start 전송되기 전에 대기할 시간(초)을 지정하는 802.1X 스키마의 startPeriod 요소입니다. 802.1X 인증 프로세스를 시작하기 위해 EAPOL-Start 메시지가 전송됩니다. 자세한 내용은 802.1X 스키 마의 startPeriod(OneX) 요소를 참조하세요.
-
dwMaxStart
-
전송된 최대 EAPOL-Start 메시지 수를 지정하는 802.1X 스키마의 maxStart 요소입니다. 최대 EAPOL-Start 메시지를 보낸 후 클라이언트는 네트워크에 인증자가 없다고 가정합니다. 자세한 내용은 802.1X 스키 마의 maxStart(OneX) 요소를 참조하세요.
-
dwMaxAuthFailures
-
자격 증명 집합에 허용되는 최대 인증 실패 수를 지정하는 802.1X 스키마의 maxAuthFailures 요소입니다. 자세한 내용은 802.1X 스키마의 maxAuthFailures(OneX) 요소를 참조하세요.
-
dwNetworkAuthTimeout
-
일반 로그온이 진행되기 전에 802.1X 인증 완료를 기다리는 시간(초)입니다. 이 값은 SSO(Single Signon) 시나리오에서 사용됩니다. 이 값은 기본적으로 802.1X 프로필에서 10초로 설정됩니다. 자세한 내용은 802.1X 스키마의 maxDelay(singleSignOn) 요소를 참조하세요.
-
dwNetworkAuthWithUITimeout
-
로그온당 SSO 중에 사용자 입력이 필요한 사용자 인터페이스 대화 상자가 표시되는 경우 연결을 기다리는 최대 기간(초)입니다.
WINDOWS Vista SP1 이상에서 이 값은 10분으로 하드 코딩되며 구성할 수 없습니다. Windows Vista Release to Manufacturing에서 이 값은 기본적으로 802.1X 프로필에서 60초로 설정되며 스키마의 maxDelayWithAdditionalDialogs 요소에 의해 제어되었습니다.
WINDOWS Vista SP1 이상에서는 802.1X 스키마의 maxDelayWithAdditionalDialogs 요소가 무시되고 더 이상 사용되지 않습니다.
-
bAllowLogonDialogs
-
사전 로그온 SSO를 사용할 때 EAP 대화 상자를 표시할지 여부를 지정하는 값입니다. 자세한 내용은 802.1X 스키마의 allowAdditionalDialogs 요소를 참조하세요.
-
bUserBasedVLan
-
디바이스에서 사용하는 VLAN(가상 LAN)이 사용자의 자격 증명에 따라 변경되는지를 지정하는 802.1X 스키마의 userBasedVirtualLan 요소입니다. 일부 NAS(네트워크 액세스 서버) 디바이스는 사용자가 인증한 후 VLAN을 변경합니다. userBasedVirtualLan이 TRUE이면 NAS는 사용자가 인증한 후 디바이스의 VLAN을 변경할 수 있습니다. 자세한 내용은 802.1X 체계의 userBasedVirtualLan(singleSignOn) 요소를 참조하세요.
설명
ONEX_CONNECTION_PROFILE 구조는 Windows Vista 이상에서 지원되는 새로운 무선 구성 구성 요소인 802.1X 모듈에서 사용됩니다.
ONEX_RESULT_UPDATE_DATA 802.1X 인증으로의 상태 변경에 대한 정보가 포함되어 있습니다. ONEX_RESULT_UPDATE_DATA 구조체는 WLAN_NOTIFICATION_DATA 구조체의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_ONEX 수신된 알림에 대한 WLAN_NOTIFICATION_DATA 구조체의 NotificationCode 멤버가 OneXNotificationTypeResultUpdate이면 반환됩니다. 이 알림의 경우 WLAN_NOTIFICATION_DATA 구조체의 pData 멤버는 802.1X 인증 상태 변경에 대한 정보가 포함된 ONEX_RESULT_UPDATE_DATA 구조를 가리킵니다.
ONEX_RESULT_UPDATE_DATA 구조체의 fOneXAuthParams 멤버가 설정된 경우 ONEX_RESULT_UPDATE_DATA 구조체의 authParams 멤버에는 ONEX_VARIABLE_BLOBdwOffset 멤버부터 시작하는 ONEX_AUTH_PARAMS 구조체가 포함된 ONEX_VARIABLE_BLOB 구조체가 포함됩니다. ONEX_AUTH_PARAMS 구조체의 oneXConnProfile 멤버에는 ONEX_VARIABLE_BLOBdwOffset 멤버부터 ONEX_CONNECTION_PROFILE 구조체가 포함된 ONEX_VARIABLE_BLOB 구조체가 포함되어 있습니다.
ONEX_CONNECTION_PROFILE 구조체는 공용 헤더 파일에 정의되어 있지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2008 [데스크톱 앱만 해당] |
추가 정보