CorBindToRuntime 함수

아티클
05/10/2023

관리되지 않는 호스트가 CLR(공용 언어 런타임)을 프로세스에 로드할 수 있도록 합니다.

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

구문

HRESULT CorBindToRuntime (  
    [in]  LPCWSTR     pwszVersion,
    [in]  LPCWSTR     pwszBuildFlavor,
    [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 요청되는 버전과 호환되는 최신 버전의 런타임을 로드합니다. 호스트는 아래에 설명된 대로 매개 변수에 대한 flags 값을 STARTUP_LOADER_SAFEMODE 전달하여 shim이 pwszVersion 정책 평가를 건너뛰고 에 지정된 정확한 버전을 로드하도록 강제할 수 있습니다.

호출자가 에 대해 null을 pwszVersion지정하면 런타임의 최신 버전이 로드됩니다. null을 전달하면 호스트가 로드되는 런타임 버전을 제어할 수 없습니다. 이 방법은 일부 시나리오에서 적절할 수 있지만 호스트에서 로드할 특정 버전을 제공하는 것이 좋습니다.

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

가 null로 설정된 경우 pwszBuildFlavor 워크스테이션 빌드가 로드됩니다. 단일 프로세서 컴퓨터에서 실행하는 경우 가 로 설정된 svr경우에도 pwszBuildFlavor 워크스테이션 빌드는 항상 로드됩니다. 그러나 가 로 svr 설정되고 동시 가비지 수집이 지정된 경우pwszBuildFlavor(매개 변수 설명 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 값을 반환합니다.

CorBindToRuntimeEx 와 CorBindToRuntime 동일한 작업을 수행하지만 CorBindToRuntimeEx 함수를 사용하면 플래그를 설정하여 CLR의 동작을 지정할 수 있습니다.

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 때 매개 변수의 flags 플래그를 CorBindToRuntimeEx 설정합니다.
버전 1 호환성 모드는 전체 프로세스 및 프로세스의 모든 애플리케이션 도메인에 적용됩니다.

요구 사항

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

헤더: MSCorEE.h

라이브러리: MSCorEE.dll

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

다음을 통해 공유

CorBindToRuntime 함수

구문

매개 변수

설명

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

요구 사항

참고 항목

추가 리소스