ONEX_EAP_ERROR 구조체(dot1x.h)
ONEX_EAP_ERROR 구조에는 802.1X 인증으로 오류가 발생할 때 802.1X EAP 오류가 포함됩니다.
구문
typedef struct _ONEX_EAP_ERROR {
DWORD dwWinError;
EAP_METHOD_TYPE type;
DWORD dwReasonCode;
GUID rootCauseGuid;
GUID repairGuid;
GUID helpLinkGuid;
DWORD fRootCauseString : 1;
DWORD fRepairString : 1;
ONEX_VARIABLE_BLOB RootCauseString;
ONEX_VARIABLE_BLOB RepairString;
} ONEX_EAP_ERROR, *PONEX_EAP_ERROR;
멤버
dwWinError
Winerror.h 헤더 파일에 정의된 오류 값입니다. 이 멤버에는 EAP 메서드가 실패한 이유도 포함되어 있습니다. EAP 메서드가 실패한 이유로 이 멤버의 기존 값은 Eaphosterror.h 헤더 파일에 정의됩니다.
몇 가지 가능한 값이 아래에 나열되어 있습니다.
type
802.1X 인증 중에 오류를 발생시킨 EAP 메서드 형식입니다. EAP_METHOD_TYPE 구조체는 Eaptypes.h 헤더 파일에 정의됩니다.
dwReasonCode
EAP 메서드가 실패한 이유입니다. 이 멤버에 대한 값 중 일부는 Eaphosterror.h 헤더 파일에 정의되고 일부는 Winerror.h 헤더 파일에 정의되어 있지만 다른 값은 가능합니다.
가능한 값은 아래에 나열되어 있습니다.
| 값 | 의미 |
|---|---|
|
하나 이상의 인수가 올바르지 않습니다. |
|
데이터가 잘못되었습니다. |
|
매개 변수가 잘못되었습니다. |
|
EAPHost는 ID 교환 후 EAP 오류를 수신했습니다. 사용자 계정을 인증하는 데 문제가 있을 수 있습니다. |
|
FormatMessage를 사용하여 반환된 오류에 대한 메시지 문자열을 가져옵니다. |
rootCauseGuid
EAPHost에서 오류의 원인을 식별하는 고유 ID입니다. EAP 메서드는 새 GUID를 정의하고 GUID를 특정 근본 원인과 연결할 수 있습니다. 이 멤버의 기존 값은 Eaphosterror.h 헤더 파일에 정의되어 있습니다.
repairGuid
보고된 오류를 수정하기 위해 수행할 수 있는 복구 작업을 식별하는 지역화 가능한 문자열에 매핑되는 고유 ID입니다. 이 멤버의 기존 값은 Eaphosterror.h 헤더 파일에 정의되어 있습니다.
helpLinkGuid
오류 또는 복구 메시지에 대한 추가 정보가 포함된 페이지의 URL을 지정하는 지역화 가능한 문자열에 매핑되는 고유 ID입니다. EAP 메서드는 잠재적으로 새 GUID를 정의하고 하나의 특정 도움말 링크와 연결할 수 있습니다. 이 멤버의 기존 값 중 일부는 Eaphosterror.h 헤더 파일에 정의되어 있습니다.
fRootCauseString
ONEX_EAP_ERROR 구조체에 RootCauseString 멤버에 근본 원인 문자열이 포함되어 있는지 여부를 나타냅니다.
fRepairString
ONEX_EAP_ERROR 구조체에 RepairString 멤버에 복구 문자열이 포함되어 있는지 여부를 나타냅니다.
RootCauseString
오류의 근본 원인을 설명하는 지역화되고 읽을 수 있는 문자열입니다. 이 멤버는 fRootCauseString 비트 필드 멤버가 설정된 경우 ONEX_VARIABLE_BLOBdwOffset 멤버에서 시작하는 NULL로 종료된 유니코드 문자열을 포함합니다.
RepairString
가능한 복구 작업을 설명하는 지역화되고 읽을 수 있는 문자열입니다. 이 멤버는 fRepairString 비트 필드 멤버가 설정된 경우 ONEX_VARIABLE_BLOBdwOffset 멤버에서 시작하는 NULL로 종료된 유니코드 문자열을 포함합니다.
설명
ONEX_EAP_ERROR 구조는 Windows Vista 이상에서 지원되는 새로운 무선 구성 구성 요소인 802.1X 모듈에서 사용됩니다.
ONEX_EAP_ERROR 구조체의 많은 멤버는 EAP_ERROR 구조체에서 유사한 멤버와 일치합니다.
ONEX_RESULT_UPDATE_DATA 802.1X 인증으로의 상태 변경에 대한 정보를 포함합니다. WLAN_NOTIFICATION_DATA 구조체의 NotificationSource 멤버가 WLAN_NOTIFICATION_SOURCE_ONEX 수신된 알림에 대한 WLAN_NOTIFICATION_DATA 구조의 NotificationCode 멤버 가 OneXNotificationTypeResultUpdate이면 ONEX_RESULT_UPDATE_DATA 구조가 반환됩니다. 이 알림의 경우 WLAN_NOTIFICATION_DATA 구조의 pData 멤버는 802.1X 인증 상태 변경에 대한 정보가 포함된 ONEX_RESULT_UPDATE_DATA 구조를 가리킵니다.
ONEX_RESULT_UPDATE_DATA 구조체의 fEapError 멤버가 설정된 경우 ONEX_RESULT_UPDATE_DATA 구조체의 eapError 멤버에는 ONEX_VARIABLE_BLOBdwOffset 멤버부터 시작하는 ONEX_EAP_ERROR 구조체가 포함된 ONEX_VARIABLE_BLOB 구조체가 포함됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 머리글 | dot1x.h |