CorBindToRuntimeHost 함수

아티클
08/09/2011

호스트에서 지정된 버전의 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을 평가하고 요청되는 버전과 호환되는 최신 버전의 런타임을 로드합니다. 호스트에서는 startupFlags 매개 변수에 STARTUP_LOADER_SAFEMODE 값을 전달하여 이 심(shim)에서 정책 확인 단계를 건너뛰고 pwszVersion에 지정된 특정 버전을 로드하도록 할 수 있습니다.

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

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

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

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

pwszHostConfigFile
[in] 로드할 CLR의 버전을 지정하는 호스트 구성 파일의 이름입니다. 파일 이름에 정규화된 경로가 포함되어 있지 않으면 해당 파일은 호출하는 실행 파일과 같은 디렉터리에 있는 것으로 간주됩니다.
pReserved
[in] 앞으로의 확장 가능성을 고려하여 예약됩니다.
startupFlags
[in] 동시 가비지 수집, 도메인 중립적인 코드 및 pwszVersion 매개 변수의 동작을 제어하는 플래그 집합입니다. 플래그가 설정되어 있지 않은 경우 기본값은 단일 도메인입니다. 다음 값이 지원됩니다.
- STARTUP_CONCURRENT_GC: 동시 가비지 수집을 사용하도록 지정합니다. 호출자가 단일 프로세서 컴퓨터에서 서버 빌드를 요청하고 동시 가비지 수집을 지정하면 워크스테이션 빌드와 비동시 가비지 수집이 대신 사용됩니다.
- STARTUP_LOADER_OPTIMIZATION_SINGLE_DOMAIN: 어셈블리를 도메인 중립적으로 로드하지 않도록 지정합니다.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN: 모든 어셈블리를 도메인 중립적으로 로드하도록 지정합니다.
- STARTUP_LOADER_OPTIMIZATION_MULTI_DOMAIN_HOST: 강력한 이름의 모든 어셈블리를 도메인 중립적으로 로드하도록 지정합니다.
- STARTUP_LOADER_SAFEMODE: pwszVersion에 전달된 특정 CLR 버전을 로드하도록 지정합니다. 심(shim)은 호환되는 최신 버전을 확인하기 위해 정책을 확인하지 않습니다.
rclsid
[in] ICorRuntimeHost 또는 ICLRRuntimeHost 인터페이스를 구현하는 coclass의 CLSID입니다. 지원되는 값은 CLSID_CorRuntimeHost 또는 CLSID_CLRRuntimeHost입니다.
riid
[in] 요청하는 인터페이스의 IID입니다. 지원되는 값은 IID_ICorRuntimeHost 또는 IID_ICLRRuntimeHost입니다.
ppv
[out] 로드된 런타임의 버전에 대한 인터페이스 포인터입니다.