EapPeerGetIdentity 함수(eapmethodpeerapis.h)

EAPHost에서 호출된 후 사용자 데이터 및 사용자 ID를 반환합니다.

구문

DWORD EapPeerGetIdentity(
  [in]      DWORD      dwFlags,
  [in]      DWORD      dwSizeofConnectionData,
  [in]      const BYTE *pConnectionData,
  [in]      DWORD      dwSizeofUserData,
  [in]      const BYTE *pUserData,
  [in]      HANDLE     hTokenImpersonateUser,
  [out]     BOOL       *pfInvokeUI,
  [in, out] DWORD      *pdwSizeOfUserDataOut,
  [out]     BYTE       **ppUserDataOut,
  [out]     LPWSTR     *ppwszIdentity,
  [out]     EAP_ERROR  **ppEapError
);

매개 변수

[in] dwFlags

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

[in] dwSizeofConnectionData

pConnectionData에 제공된 연결 데이터 버퍼의 크기(바이트)를 지정합니다.

[in] pConnectionData

불투명 구성 데이터 BLOB을 포함하는 바이트 버퍼에 대한 포인터입니다.

[in] dwSizeofUserData

pUserData에 제공된 사용자 데이터 버퍼의 크기(바이트)를 지정합니다.

[in] pUserData

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

[in] hTokenImpersonateUser

인증되는 사용자의 가장 토큰에 대한 핸들을 지정합니다. 이 핸들은 컴퓨터 인증을 수행할 때 NULL 이 됩니다. 이 핸들을 사용하여 EAP 메서드는 사용자 이름, 도메인 이름 및 자격 증명과 같은 사용자 특정 정보를 얻기 위해 사용자를 가장할 수 있습니다.

[out] pfInvokeUI

사용자 ID 및 사용자 데이터 Blob이 성공적으로 반환되지 않고 메서드가 사용자 인터페이스 대화 상자를 통해 사용자로부터 정보를 수집하려고 하면 TRUE 를 반환합니다.

[in, out] pdwSizeOfUserDataOut

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

[out] ppUserDataOut

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

[out] ppwszIdentity

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

[out] ppEapError

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

반환 값

없음

설명

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

요구 사항

추가 정보

EAPHost 피어 메서드 Run-Time 함수

EapPeerInvokeIdentityUI