CorBindToRuntimeEx 함수

아티클
08/20/2008

업데이트: 2007년 11월

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

CorBindToRuntimeEx가 사용되는 시나리오에 대한 전체 설명을 보려면 공용 언어 런타임 호스팅을 참조하십시오.

이 함수는 매개 변수 집합을 사용하여 호스트에서 다음을 수행할 수 있게 합니다.

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

참고

이전에 IA-64라고 부르던 Intel Itanium 아키텍처를 구현하는 64비트 시스템에서 WOW64 x86 에뮬레이터를 실행하는 응용 프로그램에서는 동시 가비지 수집이 지원되지 않습니다. 64비트 Windows 시스템에서 WOW64를 사용하는 방법에 대한 자세한 내용은 Running 32-bit Applications를 참조하십시오.

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

HRESULT CorBindToRuntimeEx (
        [in]  LPWSTR    pwszVersion, 
        [in]  LPWSTR    pwszBuildFlavor, 
        [in]  DWORD     startupFlags, 
        [in]  REFCLSID  rclsid, 
        [in]  REFIID    riid, 
        [out] LPVOID*   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에 지정된 특정 버전을 로드하도록 할 수 있습니다.

호출자가 pwszVersion에 null을 지정하면 최신 버전의 런타임이 로드됩니다. null을 전달하면 호스트는 로드되는 런타임 버전을 제어할 수 없습니다. 이 방법이 적절한 경우도 있지만 호스트에서 로드할 특정 버전을 지정하는 것이 훨씬 더 좋은 방법입니다.
pwszBuildFlavor
[in] CLR의 서버 빌드를 로드할지 워크스테이션 빌드를 로드할지를 지정하는 문자열입니다. 유효한 값은 svr 및 wks입니다. 서버 빌드는 가비지 수집에 여러 프로세서를 활용할 수 있도록 최적화되어 있지만 워크스테이션 빌드는 단일 프로세서 컴퓨터에서 실행되는 클라이언트 응용 프로그램에 맞게 최적화되어 있습니다.

pwszBuildFlavor가 null로 설정되면 워크스테이션 빌드가 로드됩니다. 단일 프로세서 컴퓨터에서 실행 중인 경우에는 pwszBuildFlavor가 svr로 설정되어 있더라도 항상 워크스테이션 빌드가 로드됩니다. 그러나 pwszBuildFlavor가 svr로 설정되어 있고 동시 가비지 수집이 지정되어 있으면(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_LEGACY_IMPERSONATION
- 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
[in] ICorRuntimeHost 인터페이스를 구현하는 coclass의 CLSID입니다. 지원되는 값은 CLSID_CorRuntimeHost또는 CLSID_CLRRuntimeHost입니다.
riid
[in] rclsid에서 요청된 인터페이스의 IID입니다. 지원되는 값은 IID_ICorRuntimeHost 또는 IID_ICLRRuntimeHost입니다.
ppv
[out] riid에 대한 반환된 인터페이스 포인터입니다.

설명

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

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

CLR의 버전 1에서 WindowsIdentity 개체는 새 스레드, 스레드 풀 또는 타이머 콜백과 같은 비동기 지점 간에 전달되지 않습니다. CLR의 버전 2.0에서 ExecutionContext 개체는 현재 실행 중인 스레드에 대한 일부 정보를 래핑하고 응용 프로그램 도메인 경계가 아니라 비동기 지점 간에 전달됩니다. 마찬가지로 WindowsIdentity 개체도 비동기 지점 간에 전달됩니다. 따라서 스레드에 현재 가장이 있는 경우 해당 가장도 전달됩니다.

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

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