LockClrVersion — Funkcja

Umożliwia hostowi określenie, która wersja środowiska uruchomieniowego języka wspólnego (CLR) będzie używana w procesie przed jawnym zainicjowanie środowiska CLR.

Ta funkcja została uznana za przestarzałą w .NET Framework 4.

Składnia

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

Parametry

hostCallback
[in] Funkcja, która ma być wywoływana przez clR po zainicjowaniu.

pBeginHostSetup
[in] Funkcja, która ma zostać wywołana przez hosta w celu poinformowania środowiska CLR o rozpoczęciu inicjowania.

pEndHostSetup
[in] Funkcja, która ma zostać wywołana przez hosta w celu poinformowania środowiska CLR o zakończeniu inicjowania.

Wartość zwracana

Ta metoda zwraca standardowe kody błędów COM, zgodnie z definicją w winError.h, oprócz następujących wartości.

Uwagi

Host wywołuje przed LockClrVersion zainicjowaniem środowiska CLR. LockClrVersion Przyjmuje trzy parametry, z których wszystkie są wywołaniami zwrotnymi typu FLockClrVersionCallback. Ten typ jest definiowany w następujący sposób.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();  

Podczas inicjowania środowiska uruchomieniowego są wykonywane następujące kroki:

1. Host wywołuje funkcję CorBindToRuntimeEx lub jedną z innych funkcji inicjowania środowiska uruchomieniowego. Alternatywnie host może zainicjować środowisko uruchomieniowe przy użyciu aktywacji obiektu COM.

2. Środowisko uruchomieniowe wywołuje funkcję określoną przez hostCallback parametr .

3. Funkcja określona przez hostCallback polecenie wykonuje następującą sekwencję wywołań:

   • Funkcja określona pBeginHostSetup przez parametr .

   • CorBindToRuntimeEx (lub inną funkcję inicjowania środowiska uruchomieniowego).

   • ICLRRuntimeHost::SetHostControl.

   • ICLRRuntimeHost::Start.

   • Funkcja określona pEndHostSetup przez parametr .

Wszystkie wywołania metody do pBeginHostSetup muszą występować pEndHostSetup na jednym wątku lub światłowodzie z tym samym stosem logicznym. Ten wątek może różnić się od wątku, na którym hostCallback jest wywoływany.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteka: MSCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też

• Przestarzałe funkcje hostingu środowiska CLR