EapPeerInvokeIdentityUI 함수(eapmethodpeerapis.h)

클라이언트에서 EAP 메서드에 대한 사용자 ID 정보를 가져오기 위해 사용자 지정 대화형 사용자 인터페이스 대화 상자를 발생합니다.

구문

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

매개 변수

[in] pEapType

연결을 인증하는 데 사용되는 EAP 메서드에 대한 공급업체 및 작성자 정보를 포함하는 EAP_METHOD_TYPE 구조체입니다.

[in] dwFlags

EAP 인증 세션 동작을 설명하는 EAP 플래그의 조합입니다.

[in] hwndParent

ID 데이터를 가져오기 위한 대화형 사용자 인터페이스 대화 상자를 생성하는 부모 창에 대한 핸들입니다.

[in] dwSizeOfConnectionData

pUIContextData에서 지정한 사용자 인터페이스 컨텍스트 데이터의 크기(바이트)입니다.

[in] pConnectionData

연결 데이터를 포함하는 불투명 바이트 버퍼에 대한 포인터입니다.

[out] dwSizeOfUserData

dwSizeOfUserData에 반환된 사용자 ID 데이터의 크기(바이트)를 지정합니다.

[in] pUserData

사용자 데이터를 미리 채우는 데 사용되는 이 인증과 관련된 사용자 데이터에 대한 포인터입니다. 이 API가 처음으로 호출되거나 새 인증 세션이 시작될 때 이 매개 변수는 NULL입니다. 그렇지 않으면 EapPeerGetResult에서 받은 ppResult 매개 변수가 가리키는 구조체의 pUserData 멤버로 이 매개 변수를 설정합니다.

[out] pdwSizeOfUserDataOut

ppUserDataOut 버퍼의 크기(바이트)를 지정합니다.

[out] ppUserDataOut

반환된 사용자 데이터의 포인터에 대한 포인터입니다. 데이터는 입력 pUserData로 EapPeerBeginSession에 전달됩니다.

[out] ppwszIdentity

반환된 사용자 ID에 대한 포인터입니다. 포인터는 ID 응답 패킷에 포함되고 서버로 반환됩니다.

[out] ppEapError

이 함수 호출을 실행하는 동안 발생한 오류를 포함하는 EAP_ERROR 구조체의 주소에 대한 포인터입니다. 오류 데이터를 사용한 후 EapPeerFreeErrorMemory를 호출하여 이 메모리를 해제해야 합니다.

반환 값

없음

설명

이 호출은 이 API에 대한 함수 포인터를 사용하여 피어 기반 EAPHost에 의해 수행됩니다. 이 API는 EAPHost에 의해 로드된 EAP 메서드에서 구현되어야 하며 설명서에 지정된 구문 및 매개 변수 형식을 엄격히 준수해야 합니다.

요구 사항

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

추가 정보

EAPHost 피어 메서드 구성 함수

EapPeerInvokeIdentityUI