다음을 통해 공유


EapPeerGetUIContext 함수(eapmethodpeerapis.h)

EAP 메서드에서 사용자 인터페이스 컨텍스트를 가져옵니다. 이 함수 뒤에는 항상 EapPeerInvokeInteractiveUI 함수가 이어지며, 그 뒤에 EapPeerSetUIContext 함수가 잇습니다.

구문

DWORD EapPeerGetUIContext(
  [in]  EAP_SESSION_HANDLE sessionHandle,
  [out] DWORD              *pdwSizeOfUIContextData,
  [out] BYTE               **ppUIContextData,
  [out] EAP_ERROR          **ppEapError
);

매개 변수

[in] sessionHandle

EAPHost 서버에서 이 EAP 인증 세션에 대한 고유 핸들을 포함하는 EAP_SESSION_HANDLE 구조체에 대한 포인터입니다. 이 핸들은 EapPeerBeginSession에 대한 이전 호출에서 pSessionHandle 매개 변수에 반환됩니다.

[out] pdwSizeOfUIContextData

ppUIContextData에서 반환된 사용자 인터페이스 컨텍스트 데이터 바이트 버퍼의 크기를 지정하는 값에 대한 포인터입니다.

[out] ppUIContextData

EAPHost의 사용자 인터페이스 컨텍스트 데이터가 있는 바이트 버퍼가 포함된 주소에 대한 포인터입니다.

[out] ppEapError

이 함수 호출을 실행하는 동안 발생한 오류를 포함하는 EAP_ERROR 구조체의 주소에 대한 포인터입니다. 오류 데이터를 사용한 후에는 오류 데이터에 대한 포인터를 EapPeerFreeErrorMemory에 전달하여 이 메모리를 해제해야 합니다.

반환 값

없음

설명

EapPeerGetUIContext 는 이전 호출에서 사용자 인터페이스 컨텍스트를 사용할 수 있음을 나타내는 경우 EAPHost에서 호출됩니다.

이 호출은 이 API에 대한 함수 포인터를 사용하여 피어 기반 EAPHost에 의해 수행됩니다. 이 API는 EAPHost에 의해 로드된 EAP 메서드에서 구현되어야 하며 설명서에 지정된 구문 및 매개 변수 형식을 엄격히 준수해야 합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 eapmethodpeerapis.h

추가 정보

EAPHost 피어 메서드 Run-Time 함수

EapPeerInvokeInteractiveUI

EapPeerSetUIContext