EapPeerBeginSession 함수(eapmethodpeerapis.h)
EAP 메서드를 사용하여 피어 EAPHost에서 EAP 인증 세션을 시작합니다.
구문
DWORD EapPeerBeginSession(
[in] DWORD dwFlags,
[in] const EapAttributes * const pAttributeArray,
[in] HANDLE hTokenImpersonateUser,
[in] DWORD dwSizeofConnectionData,
[in] BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] BYTE *pUserData,
[in] DWORD dwMaxSendPacketSize,
[out] EAP_SESSION_HANDLE *pSessionHandle,
[out] EAP_ERROR **ppEapError
);
매개 변수
[in] dwFlags
새 EAP 인증 세션 동작을 설명하는 EAP 플래그의 조합입니다.
[in] pAttributeArray
인증할 엔터티의 EAP 특성을 지정하는 EAP_ATTRIBUTES 배열 구조체에 대한 포인터입니다.
[in] hTokenImpersonateUser
이 세션에서 사용할 사용자 가장 토큰에 대한 핸들을 지정합니다.
[in] dwSizeofConnectionData
pConnectionData에 제공된 연결 데이터 버퍼의 크기(바이트)를 지정합니다.
[in] pConnectionData
이 API에서 반환된 사용자 데이터를 결정하는 데 사용되는 이 메서드와 관련된 연결 데이터입니다. 여기서 사용자 데이터는 특정 연결 데이터 구성에 따라 달라집니다. 이 매개 변수가 NULL 인 경우 메서드 구현은 연결에 기본값을 사용해야 합니다.
[in] dwSizeofUserData
pUserData에 제공된 사용자 데이터 버퍼의 크기(바이트)를 지정합니다.
[in] pUserData
불투명 사용자 데이터 BLOB을 포함하는 바이트 버퍼에 대한 포인터입니다.
[in] dwMaxSendPacketSize
세션 중에 전송된 EAP 패킷의 최대 크기(바이트)를 지정합니다. 메서드가 최대 크기보다 큰 패킷을 보내야 하는 경우 메서드는 조각화 및 재어셈블리를 수용해야 합니다.
[out] pSessionHandle
EAPHost 서버에서 이 EAP 인증 세션에 대한 고유 핸들을 포함하는 EAP_SESSION_HANDLE 구조체에 대한 포인터입니다.
[out] ppEapError
이 함수 호출을 실행하는 동안 발생한 오류를 포함하는 EAP_ERROR 구조체에 대한 포인터에 대한 포인터입니다. 오류 데이터를 사용한 후 EapPeerFreeErrorMemory를 호출하여 이 메모리를 해제해야 합니다.
반환 값
없음
설명
이 호출은 이 API에 대한 함수 포인터를 사용하여 피어 기반 EAPHost에 의해 수행됩니다. 이 API는 EAPHost에서 로드한 EAP 메서드에서 구현되어야 하며 설명서에 지정된 구문 및 매개 변수 형식을 엄격하게 준수해야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | eapmethodpeerapis.h |