EapHostPeerGetResult 함수(eappapis.h)
지정된 EAP 인증 세션에 대한 인증 결과를 가져옵니다.
구문
DWORD EapHostPeerGetResult(
[in] EAP_SESSIONID sessionHandle,
[in] EapHostPeerMethodResultReason reason,
[out] EapHostPeerMethodResult *ppResult,
[out] EAP_ERROR **ppEapError
);
매개 변수
[in] sessionHandle
EAPHost 서버에서 이 EAP 인증 세션에 대한 고유 핸들을 포함하는 EAP_SESSIONID 구조체에 대한 포인터입니다. 이 핸들은 EapHostPeerBeginSession에 대한 이전 호출에서 pSessionId 매개 변수에 반환됩니다.
[in] reason
ppResult에서 반환된 인증 결과에 대한 이유 코드를 지정하는 EapHostPeerMethodResultReason 열거형 값입니다.
[out] ppResult
인증 결과를 포함하는 EapHostPeerMethodResultReason 구조체에 대한 포인터입니다. EAPHost는 EapHostPeerMethodResult에 정의된 인증 관련 정보로 이 구조를 채웁니다.
[out] ppEapError
EAP_ERROR 구조체의 주소에 대한 포인터입니다. 이 함수를 호출하기 전에 주소를 NULL 로 설정해야 합니다. 오류 데이터를 사용할 수 있는 경우 이 함수 호출을 실행하는 동안 발생한 오류가 포함된 EAP_ERROR 구조체의 주소에 대한 포인터가 수신됩니다. 지원자는 인증에 성공했는지 확인하려면 이 매개 변수를 참조해야 합니다. 오류 데이터를 사용한 후 EapHostPeerFreeEapError를 호출하여 이 메모리를 해제합니다.
반환 값
함수가 성공하면 반환 값이 NO_ERROR. 반환 값은 인증에 성공했는지 여부를 나타내지 않습니다. 지원자는 인증 결과를 확인하려면 ppEapError 매개 변수를 참조해야 합니다.
함수가 실패하면 반환 값은 Winerror.h, Raserror.h 또는 Mprerror.h의 적절한 오류 코드여야 합니다.
설명
지원자는 다음 시나리오에서 발생할 수 있는 인증 완료 시 EapHostPeerGetResult 를 호출합니다.
- EapHostPeerProcessReceivedPacket에 대한 호출은 EapHostPeerResponseResult 작업 코드를 반환했습니다.
- 클라이언트 시간이 초과되어 현재 상태에 따라 결과를 얻으려고 합니다.
- 지원자는 하위 계층의 패킷에서 대체 결과를 받았습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | eappapis.h |
| 라이브러리 | Eappprxy.lib |
| DLL | Eappprxy.dll |