다음을 통해 공유

CorBindToRuntimeHost 함수

  • 아티클

호스트가 지정된 버전의 CLR(공용 언어 런타임)을 프로세스에 로드할 수 있도록 합니다.

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

구문

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

가 null, 이면 pwszVersion 메서드가 CLR 버전을 로드하지 않습니다. 대신 런타임을 로드하지 못했음을 나타내는 CLR_E_SHIM_RUNTIMELOAD 반환합니다.

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

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

참고

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

pwszHostConfigFile
[in] 로드할 CLR의 버전을 지정하는 호스트 구성 파일의 이름입니다. 파일 이름에 정규화된 경로가 포함되지 않은 경우 파일은 호출을 수행하는 실행 파일과 동일한 디렉터리에 있는 것으로 간주됩니다.

pReserved
[in] 향후 확장성을 위해 예약됩니다.

startupFlags
[in] 동시 가비지 수집, 도메인 중립 코드 및 매개 변수의 pwszVersion 동작을 제어하는 플래그 집합입니다. 플래그가 설정되지 않은 경우 기본값은 단일 도메인입니다. 지원되는 값 목록은 STARTUP_FLAGS 열거형을 참조하세요.

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

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

ppv
[out] 로드된 런타임 버전에 대한 인터페이스 포인터입니다.

요구 사항

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

헤더: MSCorEE.idl

라이브러리: MSCorEE.dll

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

참고 항목