EapHostPeerInvokeInteractiveUI 함수(eaphostpeerconfigapis.h)
사용자로부터 자격 증명을 가져오는 데 사용되는 대화형 사용자 인터페이스를 발생합니다. 예를 들어 이 함수를 사용하여 스마트 카드 자격 증명을 검색하고 사용자에게 해당 PIN을 입력하라는 메시지를 표시하는 UI를 발생시키는 데 사용할 수 있습니다.
단일 스레드 아파트먼트에 대해 COM이 초기화된 스레드에서 EapHostPeerInvokeInteractiveUI를 호출해야 합니다. COM API CoInitialize를 호출하여 이 작업을 수행할 수 있습니다. 지원자가 STA 스레드로 완료된 경우 종료하기 전에 CoUninitialize 를 호출해야 합니다.
구문
DWORD EapHostPeerInvokeInteractiveUI(
[in] HWND hwndParent,
[in] DWORD dwSizeofUIContextData,
[in] const BYTE *pUIContextData,
[out] DWORD *pdwSizeOfDataFromInteractiveUI,
[out] BYTE **ppDataFromInteractiveUI,
[out] EAP_ERROR **ppEapError
);
매개 변수
[in] hwndParent
구성 대화 상자가 표시되는 부모 창의 핸들입니다.
[in] dwSizeofUIContextData
pUIContextData 매개 변수가 가리키는 버퍼의 크기(바이트)입니다.
[in] pUIContextData
EAPHost의 유연한 UI 컨텍스트 데이터를 포함하는 버퍼에 대한 포인터입니다. 컨텍스트 데이터는 EapHostPeerGetUIContext에서 반환됩니다. 버퍼 크기는 dwSizeOfUIContextData입니다.
[out] pdwSizeOfDataFromInteractiveUI
ppDataFromInteractiveUI 매개 변수가 가리키는 버퍼의 크기(바이트)를 나타내는 DWORD에 대한 포인터입니다.
[out] ppDataFromInteractiveUI
인증을 계속하는 데 필요한 대화형 UI의 데이터를 포함하는 바이트 버퍼에 대한 포인터입니다. 매개 변수 ppDataFromInteractiveUI 는 EapHostPeerSetUIContext 에 IN 매개 변수 pUIContextData로 전달되어야 합니다. 데이터를 사용한 후 EapHostPeerFreeMemory를 호출하여 이 메모리를 해제해야 합니다. 버퍼의 크기는 pdwSizeofDataFromInteractiveUI입니다.
[out] ppEapError
이 함수 호출을 실행하는 동안 EAPHost에서 발생한 오류를 포함하는 EAP_ERROR 구조체에 대한 포인터에 대한 포인터입니다. 오류 데이터를 사용한 후 EapHostPeerFreeErrorMemory를 호출하여 이 메모리를 해제해야 합니다.
반환 값
없음
설명
supplicant가 반환되는 EAP_E_EAPHOST_METHOD_OPERATION_NOT_SUPPORTED 호출해야 합니다. 지원자는 EapHostPeerInvokeInteractiveUI를 호출하여 메서드 대화형 UI를 호출하는 기존 모델에 의존해야 합니다.
호출된 경우 EapHostPeerInvokeInteractiveUI 는 EapHostPeerGetUIContext를 호출한 후 EAP 메서드에 대한 사용자 인터페이스를 발생시킵니다. EapHostPeerProcessReceivedPacket 호출이 EapHostPeerResponseInvokeUi 작업 코드를 반환할 때 발생합니다. EapHostPeerGetUIContext 는 지원자가 EapHostPeerInvokeInteractiveUI 에 전달하여 UI를 발생시키는 UI 컨텍스트를 반환합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | eaphostpeerconfigapis.h |
| 라이브러리 | Eappcfg.lib |
| DLL | Eappcfg.dll |