LockClrVersion İşlevi

Konağın, CLR'yi açıkça başlatmadan önce işlem içinde ortak dil çalışma zamanının (CLR) hangi sürümünün kullanılacağını belirlemesine izin verir.

Bu işlev .NET Framework 4'te kullanım dışı bırakılmıştır.

Sözdizimi

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

Parametreler

hostCallback
[in] Başlatmadan sonra CLR tarafından çağrılacak işlev.

pBeginHostSetup
[in] CLR'ye başlatmanın başlatıldığını bildirmek için konak tarafından çağrılacak işlev.

pEndHostSetup
[in] BAŞLATMAnın tamamlandığını CLR'ye bildirmek için konak tarafından çağrılacak işlev.

Dönüş Değeri

Bu yöntem, WinError.h'de tanımlanan standart COM hata kodlarını, aşağıdaki değerlere ek olarak döndürür.

Dönüş kodu	Description
S_OK	Yöntem başarıyla tamamlandı.
E_INVALIDARG	Bağımsız değişkenlerden biri veya daha fazlası null.

Açıklamalar

Konak, CLR'yi başlatmadan önce çağırır LockClrVersion . LockClrVersion üç parametre alır ve bunların tümü FLockClrVersionCallback türünde geri çağırmalardır. Bu tür aşağıdaki gibi tanımlanır.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();  

Çalışma zamanı başlatıldığında aşağıdaki adımlar gerçekleşir:

1. Konak CorBindToRuntimeEx veya diğer çalışma zamanı başlatma işlevlerinden birini çağırır. Alternatif olarak, konak COM nesne etkinleştirmesini kullanarak çalışma zamanını başlatabilir.

2. Çalışma zamanı parametresi tarafından hostCallback belirtilen işlevi çağırır.

3. tarafından hostCallback belirtilen işlev aşağıdaki çağrı dizisini yapar:

   • parametresi tarafından pBeginHostSetup belirtilen işlev.

   • CorBindToRuntimeEx (veya başka bir çalışma zamanı başlatma işlevi).

   • ICLRRuntimeHost::SetHostControl.

   • ICLRRuntimeHost::Start.

   • parametresi tarafından pEndHostSetup belirtilen işlev.

'den pBeginHostSetuppEndHostSetup gelen tüm çağrılar aynı mantıksal yığına sahip tek bir iş parçacığında veya fiberde gerçekleşmelidir. Bu iş parçacığı, çağrılan hostCallback iş parçacığından farklı olabilir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

Kitaplık: MSCorEE.dll

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.

• Kullanım Dışı CLR Barındırma İşlevleri