EapPeerQueryInteractiveUIInputFields 함수(eapmethodpeerapis.h)
EapPeerQueryInteractiveUIInputFields 함수는 대화형 UI 구성 요소에 대한 입력 필드를 제공하는 EAP 메서드 API의 구현을 정의합니다.
구문
DWORD EapPeerQueryInteractiveUIInputFields(
[in] DWORD dwVersion,
[in] DWORD dwFlags,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] EAP_INTERACTIVE_UI_DATA *pEapInteractiveUIData,
[out] EAP_ERROR **ppEapError,
[in, out] LPVOID *ppvReserved
);
매개 변수
[in] dwVersion
API의 버전 번호입니다. 0으로 설정해야 합니다.
[in] dwFlags
EAP 인증 세션 동작을 설명하는 EAP 플래그의 조합입니다.
[in] dwSizeofUIContextData
pUIContextData의 컨텍스트 데이터 크기(바이트)입니다.
[in] pUIContextData
필드 데이터에 대한 내부 포인터로 표시되는 UI 컨텍스트 데이터를 포함하는 BLOB에 대한 포인터입니다. 지원자는 EAPHost 런타임 API에서 이러한 내부 포인터를 얻었습니다.
[out] pEapInteractiveUIData
EAP 지원자에서 발생한 대화형 UI 구성 요소에 대한 구성 정보를 포함하는 EAP_INTERACTIVE_UI_DATA 구조를 수신하는 포인터입니다.
[out] ppEapError
이 함수 호출을 실행하는 동안 발생한 오류가 포함된 EAP_ERROR 구조체의 주소에 대한 포인터입니다. 오류 데이터를 사용한 후에는 오류 데이터에 대한 포인터를 EapPeerFreeErrorMemory에 전달하여 이 메모리를 해제해야 합니다.
[in, out] ppvReserved
사용하도록 예약되었습니다. NULL로 설정해야 합니다.
반환 값
없음
설명
EapPeerQueryInteractiveUIInputFields를 사용하여 SSO(Single Sign-On)를 지원할 수 있습니다. EapPeerBeginSession의 EAP_FLAG_PRE_LOGON 플래그는 EAPHost에 SSO를 제공해야 했음을 나타냅니다. EapPeerBeginSession을 호출한 후 EapPeerResponseInvokeUI 작업 코드가 수신되면 EAPHost는 EapPeerQueryInteractiveUIInputFields를 호출하고 나중에 EapPeerQueryUIBlobFromInteractiveUIInputFields를 호출합니다.
supplicant는 항상 호출해야 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED 반환됩니다. 지원자는 EapPeerInvokeInteractiveUI를 호출하여 메서드 대화형 UI를 호출하는 기존 모델에 의존해야 합니다. 오류가 있는 경우 EapPeerQueryInteractiveUIInputFields 는 NULL 이외의 반환 코드를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | eapmethodpeerapis.h |