CorBindToRuntimeEx 함수

아티클
04/08/2023

관리되지 않는 호스트가 CLR(공용 언어 런타임)을 프로세스에 로드할 수 있도록 합니다. CorBindToRuntime 및 CorBindToRuntimeEx 함수는 동일한 작업을 수행하지만 CorBindToRuntimeEx 함수를 사용하면 플래그를 설정하여 CLR의 동작을 지정할 수 있습니다.

이 함수는 .NET Framework 4에서 더 이상 사용되지 않습니다.

이 함수는 호스트가 다음을 수행할 수 있도록 하는 매개 변수 집합을 사용합니다.

로드할 런타임의 버전을 지정합니다.
서버 또는 워크스테이션 빌드를 로드해야 하는지 여부를 나타냅니다.
동시 가비지 수집 또는 비동기 가비지 수집이 수행되는지 여부를 제어합니다.

참고

Intel Itanium 아키텍처(이전의 IA-64)를 구현하는 64비트 시스템에서 WOW64 x86 에뮬레이터를 실행하는 애플리케이션에서는 동시 가비지 수집이 지원되지 않습니다. 64비트 Windows에서 WOW64를 사용하는 방법에 대한 자세한 내용은 32비트 애플리케이션 실행을 참조하세요.

어셈블리가 도메인 중립으로 로드되는지 여부를 제어합니다.
시작하기 전에 CLR의 instance 구성하기 위한 추가 옵션을 설정하는 데 사용할 수 있는 ICorRuntimeHost에 대한 인터페이스 포인터를 가져옵니다.

구문

HRESULT CorBindToRuntimeEx (  
    [in]  LPCWSTR      pwszVersion,
    [in]  LPCWSTR      pwszBuildFlavor,
    [in]  DWORD        startupFlags,
    [in]  REFCLSID     rclsid,
    [in]  REFIID       riid,
    [out] LPVOID FAR  *ppv  
);

매개 변수

pwszVersion
[in] 로드하려는 CLR의 버전을 설명하는 문자열입니다.

.NET Framework 버전 번호는 마침표로 구분된 네 부분으로 구성됩니다. major.minor.build.revision. 로 pwszVersion 전달된 문자열은 "v" 문자 뒤에 버전 번호의 처음 세 부분(예: "v1.0.1529")으로 시작해야 합니다.

CLR의 일부 버전은 이전 버전의 CLR과의 호환성을 지정하는 정책 문과 함께 설치됩니다. 기본적으로 시작 shim은 정책 문에 대해 평가하고 pwszVersion 요청되는 버전과 호환되는 최신 버전의 런타임을 로드합니다. 호스트는 아래에 설명된 대로 매개 변수에 대한 startupFlags 값을 STARTUP_LOADER_SAFEMODE 전달하여 shim이 pwszVersion 정책 평가를 건너뛰고 에 지정된 정확한 버전을 로드하도록 강제할 수 있습니다.

호출자가 에 대해 null을 pwszVersionCorBindToRuntimeEx 지정하는 경우 버전 번호가 .NET Framework 4 런타임보다 낮은 설치된 런타임 집합을 식별하고 해당 집합에서 최신 버전의 런타임을 로드합니다. .NET Framework 4 이상을 로드하지 않으며 이전 버전이 설치되지 않은 경우 실패합니다. null을 전달하면 호스트가 로드되는 런타임 버전을 제어할 수 없습니다. 이 방법은 일부 시나리오에서 적절할 수 있지만 호스트에서 로드할 특정 버전을 제공하는 것이 좋습니다.

pwszBuildFlavor
[in] CLR의 서버 또는 워크스테이션 빌드를 로드할지 여부를 지정하는 문자열입니다. 유효한 값은 svr 및 wks입니다. 서버 빌드는 가비지 수집을 위해 여러 프로세서를 활용하도록 최적화되었으며 워크스테이션 빌드는 단일 프로세서 컴퓨터에서 실행되는 클라이언트 애플리케이션에 최적화되어 있습니다.

가 null로 설정된 경우 pwszBuildFlavor 워크스테이션 빌드가 로드됩니다. 단일 프로세서 컴퓨터에서 실행하는 경우 가 로 설정된 svr경우에도 pwszBuildFlavor 워크스테이션 빌드는 항상 로드됩니다. 그러나 가 로 svr 설정되고 동시 가비지 수집이 지정된 경우pwszBuildFlavor(매개 변수 설명 startupFlags 참조) 서버 빌드가 로드됩니다.

startupFlags
[in] STARTUP_FLAGS 열거형 값의 조합입니다. 이러한 플래그는 동시 가비지 수집, 도메인 중립 코드 및 매개 변수의 동작을 제어합니다 pwszVersion . 플래그가 설정되지 않은 경우 기본값은 단일 도메인입니다. 유효한 값은 다음과 같습니다.

STARTUP_CONCURRENT_GC
STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN
STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN
STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST
STARTUP_LOADER_SAFEMODE
STARTUP_LOADER_SETPREFERENCE
STARTUP_SERVER_GC
STARTUP_HOARD_GC_VM
STARTUP_SINGLE_VERSION_HOSTING_INTERFACE
STARTUP_LEGACY_IMPERSONATION
STARTUP_DISABLE_COMMITTHREADSTACK
STARTUP_ALWAYSFLOW_IMPERSONATION

이러한 플래그에 대한 설명은 STARTUP_FLAGS 열거형을 참조하세요.

rclsid
진행 ICorRuntimeHost 또는 ICLRRuntimeHost 인터페이스를 구현 하는 coclass 의 CLSID입니다. 지원되는 값은 CLSID_CorRuntimeHost 또는 CLSID_CLRRuntimeHost.

riid
[in] IID 에서 요청된 인터페이스의 입니다 rclsid. 지원되는 값은 IID_ICorRuntimeHost 또는 IID_ICLRRuntimeHost.

ppv
[out] 에 대한 반환된 인터페이스 포인터입니다 riid.

설명

존재하지 CorBindToRuntimeEx 않는 런타임 버전을 지정하면 pwszVersion CLR_E_SHIM_RUNTIMELOAD HRESULT 값을 반환합니다.

Windows ID의 실행 컨텍스트 및 흐름

CLR 버전 1에서 개체는 새 스레드, WindowsIdentity 스레드 풀 또는 타이머 콜백과 같은 비동기 지점에서 흐르지 않습니다. CLR ExecutionContext 버전 2.0에서 개체는 현재 실행 중인 스레드에 대한 일부 정보를 래핑하고 애플리케이션 도메인 경계를 넘지 않고 비동기 지점 간에 흐릅니다. 마찬가지로 개체는 WindowsIdentity 비동기 지점 간에도 흐릅니다. 따라서 스레드의 현재 가장(있는 경우)도 흐릅니다.

다음 두 가지 방법으로 흐름을 변경할 수 있습니다.

스레드별로 흐름을 표시하지 않도록 설정을 수정 ExecutionContext 합니다(, SuppressFlow및 SuppressFlowWindowsIdentity 메서드 참조SuppressFlow).
프로세스 기본 모드를 버전 1 호환 모드로 변경하여 현재 스레드의 WindowsIdentity ExecutionContext 설정에 관계없이 개체가 비동기 지점 간에 흐르지 않습니다. 기본 모드를 변경하는 방법은 관리형 실행 파일 또는 관리되지 않는 호스팅 인터페이스를 사용하여 CLR을 로드하는지 여부에 따라 달라집니다.
1. 관리되는 실행 파일의 경우 legacyImpersonationPolicy> 요소의< 특성을 로 설정 enabled 해야 합니다.true
2. 관리되지 않는 호스팅 인터페이스의 경우 함수를 호출할 STARTUP_LEGACY_IMPERSONATION 때 매개 변수의 startupFlags 플래그를 CorBindToRuntimeEx 설정합니다.
버전 1 호환성 모드는 전체 프로세스 및 프로세스의 모든 애플리케이션 도메인에 적용됩니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: MSCorEE.dll

.NET Framework 버전: 1.0부터 사용 가능

다음을 통해 공유

CorBindToRuntimeEx 함수

구문

매개 변수

설명

Windows ID의 실행 컨텍스트 및 흐름

요구 사항

참고 항목

추가 리소스