ITSGPolicyEngine::AuthorizeResource 메서드(tsgpolicyengine.h)
지정된 연결에 연결할 권한이 있는 리소스를 결정합니다.
RD 게이트웨이(원격 데스크톱 게이트웨이)는 사용자가 성공적으로 인증된 후 이 메서드를 호출합니다. 그런 다음 권한 부여 플러그 인은 ITSGAuthorizeConnectionSink 인터페이스를 사용하여 RD 게이트웨이에 권한 부여 결과를 알려야 합니다.
구문
HRESULT AuthorizeResource(
[in] GUID mainSessionId,
[in] int subSessionId,
[in] BSTR username,
[in] BSTR *resourceNames,
[in] ULONG numResources,
[in] BSTR *alternateResourceNames,
[in] ULONG numAlternateResourceName,
[in] ULONG portNumber,
[in] BSTR operation,
[in] BYTE *cookie,
[in] ULONG numBytesInCookie,
[in] ITSGAuthorizeResourceSink *pSink
);
매개 변수
[in] mainSessionId
RD 게이트웨이에서 연결 요청에 할당된 고유 식별자입니다.
[in] subSessionId
RD 게이트웨이에서 하위 인스턴스에 할당된 고유 식별자입니다. 하위 세션은 다른 세션에서 시작된 세션입니다.
[in] username
사용자 이름입니다.
[in] resourceNames
권한을 부여할 리소스 목록입니다.
[in] numResources
resourceNames 매개 변수에서 참조하는 리소스 수입니다.
[in] alternateResourceNames
대체 리소스 이름 목록이 포함된 BSTR 에 대한 포인터입니다. 이 매개 변수는 RD 연결 브로커가 사용 중인 경우에만 유효합니다.
[in] numAlternateResourceName
alternateResourceNames 매개 변수에서 참조하는 대체 리소스 이름 수입니다.
[in] portNumber
사용자가 지정한 포트 번호입니다.
[in] operation
사용자가 리소스에서 시도하는 작업입니다. 이 매개 변수는 항상 "RDP"로 설정됩니다.
[in] cookie
사용자가 제공한 쿠키를 포함하는 BYTE 에 대한 포인터입니다. 사용자가 쿠키를 사용하여 인증하지 않은 경우 이 매개 변수는 NULL입니다.
[in] numBytesInCookie
쿠키 매개 변수에서 참조하는 바이트 수입니다.
[in] pSink
권한 부여 플러그 인이 RD 게이트웨이에 권한 부여 결과를 알리는 데 사용해야 하는 ITSGAuthorizeResourceSink 인터페이스에 대한 포인터입니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.
설명
이 메서드가 S_OK 반환하는 경우 RD 게이트웨이는 권한 부여 플러그 인이 ITSGAuthorizeResourceSink 인터페이스의 메서드를 호출할 때까지 기다립니다. 다른 값이 반환되면 RD 게이트웨이는 권한 부여 요청을 즉시 거부합니다.
권한 부여에 1초 이상이 필요한 경우 권한 부여를 수행하기 위해 별도의 스레드를 시작하는 것이 좋습니다.
AuthorizeResource 메서드를 사용하는 샘플은 원격 데스크톱 게이트웨이 플러그형 인증 및 권한 부여 샘플을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 |
| 지원되는 최소 서버 | Windows Server 2008 R2 |
| 대상 플랫폼 | Windows |
| 헤더 | tsgpolicyengine.h |