RasEapInvokeInteractiveUI 함수(raseapif.h)

아티클
08/25/2023

RAS 연결 관리자는 RasEapInvokeInteractiveUI 함수를 호출하여 사용자로부터 인증 데이터를 가져오는 대화 상자를 표시합니다.

구문

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

매개 변수

[in] dwEapTypeId

대화형 UI를 호출할 인증 프로토콜을 지정합니다.

[in] hwndParent

대화 상자의 부모 창에 대한 핸들입니다.

[in] pUIContextData

대화형 UI에 대한 컨텍스트 데이터에 대한 포인터입니다. 인증 프로토콜은 이 데이터에 대한 포인터를 PPP_EAP_OUTPUT 구조의 멤버로 제공합니다. RAS 연결 관리자 PPP_EAP_OUTPUT 구조를 RasEapMakeMessage 함수에서 출력 매개 변수로 받습니다.

[in] dwSizeOfUIContextData

컨텍스트 데이터의 크기를 지정합니다. 인증 프로토콜은 크기를 PPP_EAP_OUTPUT 구조의 멤버로 제공합니다. RAS 연결 관리자 PPP_EAP_OUTPUT 구조를 RasEapMakeMessage 함수에서 출력 매개 변수로 받습니다.

ppDataFromInteractiveUI

[out] 포인터 변수에 대한 포인터입니다. 반환이 성공하면 이 포인터 변수는 대화형 UI에서 가져온 데이터가 포함된 메모리 버퍼를 가리킵니다. 대화형 UI는 이 메모리를 할당합니다. RAS는 이 데이터를 PPP_EAP_INPUT 구조의 인증 프로토콜로 다시 전달한 다음 RAS는 RasEapFreeMemory를 호출하여 이 메모리를 해제합니다.

대화형 UI가 사용자별 데이터를 가져오지 않는 경우 ppUserData 가 가리키는 포인터를 NULL로 설정해야 합니다.

[out] pdwSizeOfDataFromInteractiveUI

대화형 UI에서 반환된 데이터의 크기를 수신하는 DWORD 변수에 대한 포인터입니다. 대화형 UI가 사용자별 데이터를 가져오지 않는 경우 DWORD 변수를 0으로 설정해야 합니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR. ppDataFromInteractiveUI 및 lpdwSizeOfDataFromInteractiveUI 매개 변수를 확인하여 함수가 대화형 UI에서 데이터를 반환했는지 확인합니다.

함수가 데이터에 대한 메모리를 할당할 수 없는 경우 반환 값은 ERROR_NOT_ENOUGH_MEMORY 합니다.

함수가 다른 방법으로 실패하는 경우 반환 값은 Winerror.h, Raserror.h 또는 Mprerror.h의 적절한 오류 코드여야 합니다.

설명

RasEapInvokeInteractiveUI 및 RasEapFreeMemory 함수를 구현하는 DLL은 둘 이상의 인증 프로토콜을 지원할 수 있습니다. dwEapTypeId 매개 변수는 대화형 UI를 호출할 인증 프로토콜을 지정합니다.

대화형 UI에서 반환된 데이터에 대한 포인터는 PPP_EAP_INPUT 구조의 pDataFromInteractiveUI 멤버의 인증 프로토콜로 다시 전달됩니다. PPP_EAP_INPUT 구조체는 RasEapMakeMessage 함수에 매개 변수로 전달됩니다.

대화형 사용자 인터페이스는 LOWORD(wParam)가 IDCANCEL과 같은 WM_COMMAND 메시지를 지원해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	raseapif.h