ITSGAuthorizeConnectionSink::OnConnectionAuthorized 메서드(tsgpolicyengine.h)

아티클
03/13/2024

연결에 권한을 부여하려는 시도의 결과에 대해 RD 게이트웨이(원격 데스크톱 게이트웨이)에 알합니다.

구문

HRESULT OnConnectionAuthorized(
  [in] HRESULT                     hrIn,
  [in] GUID                        mainSessionId,
  [in] ULONG                       cbSoHResponse,
  [in] BYTE                        *pbSoHResponse,
  [in] ULONG                       idleTimeout,
  [in] ULONG                       sessionTimeout,
  [in] SESSION_TIMEOUT_ACTION_TYPE sessionTimeoutAction,
  [in] AATrustClassID              trustClass,
  [in] PolicyAttributes            policyAttributes
);

매개 변수

[in] hrIn

권한 부여 시도의 결과입니다. S_OK 지정하여 시도가 성공했음을 나타냅니다. 다른 값을 지정하여 시도가 실패했음을 나타냅니다.

[in] mainSessionId

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

[in] cbSoHResponse

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

[in] pbSoHResponse

SoH(상태 문)에 대한 요청에 대한 응답을 지정하는 BYTE 에 대한 포인터입니다. hrIn 매개 변수가 S_OK 않으면 이 매개 변수는 무시됩니다.

[in] idleTimeout

연결이 끊기기 전에 유휴 상태로 유지될 수 있는 시간(분)입니다. hrIn 매개 변수가 S_OK 않으면 이 매개 변수는 무시됩니다.

[in] sessionTimeout

세션에 할당된 최대 시간(분)입니다. hrIn 매개 변수가 S_OK 않으면 이 매개 변수는 무시됩니다.

[in] sessionTimeoutAction

세션 시간이 초과될 때 수행할 작업입니다. hrIn 매개 변수가 S_OK 않으면 이 매개 변수는 무시됩니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

SESSION_TIMEOUT_ACTION_DISCONNECT

세션 연결을 끊습니다.

SESSION_TIMEOUT_ACTION_SILENT_REAUTH

세션을 자동으로 다시 인증하고 다시 인증합니다.

[in] trustClass

이 매개 변수는 예약되어 있습니다. 항상 AA_TRUSTEDUSER_TRUSTEDCLIENT 설정합니다. hrIn 매개 변수가 S_OK 않으면 이 매개 변수는 무시됩니다.

[in] policyAttributes

연결과 연결된 리디렉션 설정을 지정하는 부울 값의 배열입니다. 배열의 각 요소는 PolicyAttributeType 열거형의 값에 해당합니다. hrIn 매개 변수가 S_OK 않으면 이 매개 변수는 무시됩니다.

반환 값

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

설명

AuthorizeConnection 구현에서 이 메서드를 호출할 수 있습니다. 인증에 1초 이상이 필요한 경우 인증을 수행하기 위해 별도의 스레드를 시작하는 것이 좋습니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7
지원되는 최소 서버	Windows Server 2008 R2
대상 플랫폼	Windows
헤더	tsgpolicyengine.h

추가 정보

ITSGAuthorizeConnectionSink

다음을 통해 공유