RasEapInvokeConfigUI 함수(raseapif.h)

아티클
08/25/2023

RAS 연결 관리자는 RasEapInvokeConfigUI 함수를 호출하여 사용자로부터 구성 정보를 가져오는 대화 상자를 표시합니다. RAS는 항목에 대한 인증 프로토콜이 구성 사용자 인터페이스를 제공하는 경우 새 전화 번호부 항목을 만들거나 기존 전화 번호부 항목을 편집할 때 RasEapInvokeConfigUI 를 호출합니다.

구문

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

매개 변수

[in] dwEapTypeId

구성 UI를 호출할 인증 프로토콜을 지정합니다.

[in] hwndParent

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

[in] dwFlags

인증 프로세스를 한정하는 다음 플래그 중 0개 이상을 지정합니다.

플래그	의미
RAS_EAP_FLAG_ROUTER	전화를 걸고 있는 컴퓨터가 라우터임을 지정합니다. 이 플래그가 없는 경우 에서 전화를 거는 컴퓨터가 RAS 클라이언트임을 나타냅니다.
RAS_EAP_FLAG_8021X_AUTH	이 세션이 무선 컨텍스트에서 실행 중임을 지정합니다.
RAS_EAP_FLAG_GUEST_ACCESS	클라이언트가 게스트 액세스를 원하는지 지정합니다. 이 플래그는 일반적으로 무선 연결의 경우 N번 연속 시도에 대해 인증이 실패하는 경우 무선 클라이언트가 게스트 액세스를 요청하도록 구성된 경우 이 플래그를 전달하여 수행합니다. 게스트 액세스를 허용하려면 RADIUS 서버를 설정해야 합니다.

[in] pConnectionDataIn

현재 전화 번호부 항목에 저장된 연결 데이터에 대한 포인터입니다. 전화 번호부 항목에 데이터가 없는 경우 이 매개 변수는 NULL입니다.

[in] dwSizeOfConnectionDataIn

현재 전화 번호부 항목에 저장된 연결 데이터의 크기를 지정합니다. 이 연결의 전화 번호부 항목에 데이터가 없는 경우 이 매개 변수는 0입니다.

[out] ppConnectionDataOut

성공적으로 반환할 때 전화 번호부 항목에 저장할 새 연결 데이터를 가리키는 포인터에 대한 포인터입니다. 이 데이터는 현재 컴퓨터와 관련이 없어야 합니다. 전화 번호부 항목은 컴퓨터에서 컴퓨터로 이식할 수 있어야 합니다.

[out] pdwSizeOfConnectionDataOut

전화 번호부 항목에 저장할 새 연결 데이터의 크기를 받는 DWORD 에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

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

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

설명

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

RAS는 RasEapInvokeConfigUI 에서 반환된 연결 데이터를 클라이언트 컴퓨터의 연결에 대한 전화 번호부 항목에 저장합니다.

요구 사항


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