IHostSecurityManager::OpenThreadToken 메서드
현재 실행 중인 스레드에 연결된 임의 액세스 토큰을 엽니다.
HRESULT OpenThreadToken (
[in] DWORD dwDesiredAccess,
[in] BOOL bOpenAsSelf,
[out] HANDLE *phThreadToken
);
매개 변수
dwDesiredAccess
[in] 스레드 토큰에 대해 요청된 액세스 형식을 지정하는 액세스 값의 마스크입니다. 이러한 값은 Win32 OpenThreadToken 함수에 정의되어 있습니다. 요청된 액세스 형식은 토큰의 DACL(임의 액세스 제어 목록)을 기준으로 허용/거부가 결정됩니다.bOpenAsSelf
[in] 호출 스레드 프로세스의 보안 컨텍스트를 사용하여 액세스 검사를 하려면 true이고, 호출 스레드 자체의 보안 컨텍스트를 사용하여 액세스 검사를 하려면 false입니다. 스레드가 클라이언트를 가장하는 경우 보안 컨텍스트는 클라이언트 프로세스의 보안 컨텍스트가 될 수 있습니다.phThreadToken
[out] 새로 연 액세스 토큰에 대한 포인터입니다.
반환 값
HRESULT |
설명 |
|---|---|
S_OK |
OpenThreadToken에서 성공적으로 반환되었습니다. |
HOST_E_CLRNOTAVAILABLE |
CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다. |
HOST_E_TIMEOUT |
호출 시간이 초과되었습니다. |
HOST_E_NOT_OWNER |
호출자가 잠금을 소유하고 있지 않습니다. |
HOST_E_ABANDONED |
차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다. |
E_FAIL |
알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다. |
설명
IHostSecurityManager::OpenThreadToken은 이름이 같은 Win32 함수와 동작 방식이 유사하지만 Win32 함수를 사용하면 호출자가 임의의 스레드에 핸들을 전달할 수 있는 반면 IHostSecurityManager::OpenThreadToken을 사용하면 호출 스레드에 연결된 토큰만 열린다는 점이 다릅니다.
HANDLE 형식은 COM과 호환되지 않습니다. 즉, 이 형식의 크기는 운영 체제에 따라 다르며 사용자 지정 마샬링을 필요로 합니다. 따라서 이 토큰은 CLR과 호스트 사이의 프로세스에서만 사용할 수 있습니다.
요구 사항
플랫폼: .NET Framework 시스템 요구 사항 참조
헤더: MSCorEE.h
라이브러리: MSCorEE.dll에 리소스로 포함됨
.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0