다음을 통해 공유

LockClrVersion 함수

  • 아티클

호스트에서 CLR을 명시적으로 초기화하기 전에 프로세스 내에서 사용할 CLR(공용 언어 런타임) 버전을 결정할 수 있습니다.

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

구문

HRESULT LockClrVersion (  
    [in] FLockClrVersionCallback   hostCallback,  
    [in] FLockClrVersionCallback  *pBeginHostSetup,  
    [in] FLockClrVersionCallback  *pEndHostSetup  
);

매개 변수

hostCallback
[in] 초기화 시 CLR에서 호출할 함수입니다.

pBeginHostSetup
[in] 초기화가 시작되고 있음을 CLR에 알리기 위해 호스트에서 호출할 함수입니다.

pEndHostSetup
[in] 초기화가 완료되었음을 CLR에 알리기 위해 호스트에서 호출할 함수입니다.

Return Value

이 메서드는 다음 값 외에도 WinError.h에 정의된 표준 COM 오류 코드를 반환합니다.

반환 코드 설명
S_OK 메서드가 완료되었습니다.
E_INVALIDARG 하나 이상의 인수가 null입니다.

설명

호스트는 CLR을 초기화하기 전에 LockClrVersion을 호출합니다. LockClrVersion은 세 개의 매개 변수를 사용합니다. 이 매개 변수는 모두 FLockClrVersionCallback 형식의 콜백입니다. 클래스는 다음과 같이 정의됩니다.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

다음 단계는 런타임을 초기화할 때 발생합니다.

  1. 호스트는 CorBindToRuntimeEx 또는 다른 런타임 초기화 함수 중 하나를 호출합니다. 또는 호스트가 COM 개체 활성화를 사용하여 런타임을 초기화할 수 있습니다.

  2. 런타임은 hostCallback 매개 변수로 지정된 함수를 호출합니다.

  3. 그런 다음 hostCallback에서 지정된 함수는 다음과 같은 일련의 호출을 수행합니다.

모든 호출(pBeginHostSetup~pEndHostSetup)은 동일한 논리 스택을 사용하여 단일 스레드 또는 파이버에서 발생해야 합니다. 이 스레드는 hostCallback이 호출되는 스레드와 다를 수 있습니다.

요구 사항

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

헤더: MSCorEE.h

라이브러리: MSCorEE.dll

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

참고 항목