ITSGPolicyEngine::AuthorizeConnection 메서드(tsgpolicyengine.h)
지정된 연결이 RD 게이트웨이(원격 데스크톱 게이트웨이)에 연결할 수 있는 권한이 있는지 여부를 확인합니다.
RD 게이트웨이는 사용자가 성공적으로 인증된 후 이 메서드를 호출합니다. 그런 다음 권한 부여 플러그 인은 ITSGAuthorizeConnectionSink 인터페이스를 사용하여 RD 게이트웨이에 권한 부여 결과를 알려야 합니다.
구문
HRESULT AuthorizeConnection(
[in] GUID mainSessionId,
[in] BSTR username,
[in] AAAuthSchemes authType,
[in] BSTR clientMachineIP,
[in] BSTR clientMachineName,
[in] BYTE *sohData,
[in] ULONG numSOHBytes,
[in] BYTE *cookieData,
[in] ULONG numCookieBytes,
[in] HANDLE_PTR userToken,
[in] ITSGAuthorizeConnectionSink *pSink
);
매개 변수
[in] mainSessionId
RD 게이트웨이에서 연결 요청에 할당된 고유 식별자입니다.
[in] username
사용자 이름입니다.
[in] authType
RD 게이트웨이에 연결하는 데 사용되는 인증 유형을 지정하는 AAAuthSchemes 열거형 형식의 값입니다.
[in] clientMachineIP
사용자 컴퓨터의 IP 주소입니다.
[in] clientMachineName
사용자 컴퓨터의 이름입니다.
[in] sohData
사용자의 컴퓨터에서 제공하는 SoH(상태 문)를 포함하는 BYTE 에 대한 포인터입니다. 권한 부여 플러그 인에 상태 문이 필요하지 않은 경우 이 매개 변수는 NULL입니다. 자세한 내용은 IsQuarantineEnabled 메서드를 참조하세요.
[in] numSOHBytes
sohData 매개 변수에서 참조하는 바이트 수입니다.
[in] cookieData
사용자가 제공한 쿠키를 포함하는 BYTE 에 대한 포인터입니다. authType 매개 변수가 AA_AUTH_COOKIE 설정되지 않은 경우 이 매개 변수는 NULL입니다.
[in] numCookieBytes
cookieData 매개 변수에서 참조하는 바이트 수입니다.
[in] userToken
사용자의 사용자 토큰을 지정하는 HANDLE 에 대한 포인터입니다. 사용자가 Windows를 실행하지 않는 경우 이 매개 변수는 NULL입니다.
[in] pSink
권한 부여 플러그 인이 RD 게이트웨이에 권한 부여 결과를 알리는 데 사용해야 하는 ITSGAuthorizeConnectionSink 인터페이스에 대한 포인터입니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드가 S_OK 반환하는 경우 RD 게이트웨이는 권한 부여 플러그 인이 ITSGAuthorizeConnectionSink 인터페이스의 메서드를 호출할 때까지 기다립니다. 다른 값이 반환되면 RD 게이트웨이는 권한 부여 요청을 즉시 거부합니다.
권한 부여에 1초 이상이 필요한 경우 권한 부여를 수행하기 위해 별도의 스레드를 시작하는 것이 좋습니다.
AuthorizeConnection 메서드를 사용하는 샘플은 원격 데스크톱 게이트웨이 플러그형 인증 및 권한 부여 샘플을 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 |
| 지원되는 최소 서버 | Windows Server 2008 R2 |
| 대상 플랫폼 | Windows |
| 헤더 | tsgpolicyengine.h |