RasGetEapUserIdentityA 함수(ras.h)

아티클
08/25/2023

RasGetEapUserIdentity 함수는 현재 사용자의 ID 정보를 검색합니다. 이 정보를 사용하여 EAP(확장 가능한 인증 프로토콜)가 필요한 전화 번호부 항목으로 RasDial 을 호출합니다.

구문

DWORD RasGetEapUserIdentityA(
  [in]  LPCSTR                pszPhonebook,
  [in]  LPCSTR                pszEntry,
  [in]  DWORD                 dwFlags,
  [in]  HWND                  hwnd,
  [out] LPRASEAPUSERIDENTITYA *ppRasEapUserIdentity
);

매개 변수

[in] pszPhonebook

PBK(전화 번호부) 파일의 전체 경로를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 이 매개 변수가 NULL인 경우 함수는 시스템 전화 번호부를 사용합니다.

[in] pszEntry

기존 항목 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.

[in] dwFlags

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

플래그	의미
RASEAPF_NonInteractive	인증 프로토콜이 그래픽 사용자 인터페이스를 표시해서는 안 되도록 지정합니다. 이 플래그가 없으면 프로토콜에서 사용자 인터페이스를 표시해도 됩니다.
RASEAPF_Logon	WinLogon에서 사용자 데이터를 가져오게 지정합니다.
RASEAPF_Preview	전화를 걸기 전에 사용자에게 ID 정보를 묻는 메시지를 표시하도록 지정합니다.

[in] hwnd

UI 대화 상자의 부모 창에 대한 핸들입니다. fInvokeUI 매개 변수가 FALSE이면 hwnd는 NULL이어야 합니다.

[out] ppRasEapUserIdentity

반환이 성공하면 EAP 사용자 ID 정보가 포함된 RASEAPUSERIDENTITY 구조체의 주소를 수신하는 포인터에 대한 포인터입니다. RasGetEapUserIdentity 는 RASEAPUSERIDENTITY 구조체에 대한 메모리 버퍼를 할당합니다. RasFreeEapUserIdentity를 호출하여 이 메모리를 해제합니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 또는 라우팅 및 원격 액세스 오류 코드 또는 Winerror.h의 값 중 하나입니다.

값	의미
E_INVALID_ARG	pcbEapUserIdentity 매개 변수는 NULL입니다.
ERROR_INTERACTIVE_MODE	함수는 RASEAPF_NonInteractive 플래그를 사용하여 호출되었습니다. 그러나 인증 프로토콜은 사용자로부터 필요한 ID 정보를 얻기 위해 UI를 표시해야 합니다.
ERROR_INVALID_FUNCTION_FOR_ENTRY	이 전화 번호부 항목에 대한 인증 방법이 EAP가 아니거나 인증 방법이 EAP이지만 프로토콜은 표준 Windows NT/Windows 2000 자격 증명 대화 상자를 사용하여 사용자 ID 정보를 가져옵니다. 두 경우 모두 호출자는 EAP ID 정보를 RasDial에 전달할 필요가 없습니다.
ERROR_RASMAN_CANNOT_INITIALIZE	원격 액세스 서비스가 제대로 초기화되지 못했습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

RasGetEapUserIdentity 는 RAS 함수 RasGetEapUserData 및 EAP 함수 RasEapGetIdentity를 호출합니다. RasEapGetIdentity 는 인증 프로토콜에 의해 구현됩니다.

함수가 성공하면 반환 값이 NO_ERROR 호출자는 ppRasEapUserIdentity 매개 변수가 가리키는 RASEAPUSERIDENTITY 구조체의 EAP ID 정보를 RasDial 호출에 사용되는 RASDIALPARAMS 및 RASDIALEXTENSIONS 구조체에 복사해야 합니다.

개발 중인 원격 액세스 애플리케이션에 그래픽 사용자 인터페이스가 있는 경우 RasGetEapUserIdentity 호출자는 RASEAPF_NonInteractive 플래그를 지정하지 않아야 합니다. 애플리케이션에 명령줄 사용자 인터페이스가 있는 경우 호출자는 인증 프로토콜이 그래픽 사용자 인터페이스를 표시하지 못하도록 RASEAPF_NonInteractive 플래그를 지정할 수 있습니다.

참고

ras.h 헤더는 RAsGetEapUserIdentity를 별칭으로 정의하여 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ras.h
라이브러리	Rasapi32.lib
DLL	Rasapi32.dll