Udostępnij za pośrednictwem

LockClrVersion — Funkcja

  • Artykuł

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.

Kod powrotu Opis
S_OK Metoda została ukończona pomyślnie.
E_INVALIDARG Co najmniej jeden argument ma wartość null.

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ń:

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ż