ITSGAuthenticationEngine::AuthenticateUser 메서드(tsgauthenticationengine.h)

사용자를 인증합니다.

RD 게이트웨이(원격 데스크톱 게이트웨이)는 새 연결 요청을 받을 때 이 메서드를 호출합니다. 인증 플러그 인은 cookieData 매개 변수에서 참조하는 쿠키를 기반으로 사용자를 인증해야 합니다. 그런 다음 인증 플러그 인은 ITSGAuthenticateUserSink 인터페이스를 사용하여 RD 게이트웨이에 인증 결과를 알려야 합니다.

구문

HRESULT AuthenticateUser(
  [in] GUID                     mainSessionId,
  [in] BYTE                     *cookieData,
  [in] ULONG                    numCookieBytes,
  [in] ULONG_PTR                context,
  [in] ITSGAuthenticateUserSink *pSink
);

매개 변수

[in] mainSessionId

RD 게이트웨이에서 연결 요청에 할당된 고유 식별자입니다.

[in] cookieData

사용자가 제공한 쿠키를 포함하는 BYTE 에 대한 포인터입니다.

[in] numCookieBytes

cookieData 매개 변수에서 참조하는 바이트 수입니다.

[in] context

이 연결과 관련된 값을 포함하는 ULONG 에 대한 포인터입니다. 이 값은 ITSGAuthenticateUserSink 인터페이스의 메서드를 사용하여 RD 게이트웨이로 다시 전달되어야 합니다.

[in] pSink

인증 플러그 인이 RD 게이트웨이에 인증 결과를 알리는 데 사용해야 하는 ITSGAuthenticateUserSink 인터페이스에 대한 포인터입니다.

반환 값

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드가 S_OK 반환하는 경우 RD 게이트웨이는 인증 플러그 인이 ITSGAuthenticateUserSink 인터페이스의 메서드를 호출할 때까지 기다립니다. 다른 값이 반환되면 RD 게이트웨이는 연결 요청을 즉시 거부합니다.

AuthenticateUser 메서드를 사용하는 샘플은 원격 데스크톱 게이트웨이 플러그형 인증 및 권한 부여 샘플을 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
대상 플랫폼	Windows
헤더	tsgauthenticationengine.h

추가 정보

ITSGAuthenticationEngine