LockClrVersion-Funktion

Artikel
06/04/2023

Ermöglicht dem Host, zu bestimmen, welche Version der Common Language Runtime (CLR) innerhalb des Prozesses verwendet werden soll, bevor die CLR explizit initialisiert wird.

Diese Funktion ist in .NET Framework 4 veraltet.

Syntax

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

Parameter

hostCallback
[in] Die Funktion, die von der CLR bei der Initialisierung aufgerufen wird.

pBeginHostSetup
[in] Die Funktion, die vom Host aufgerufen wird, um die CLR zu informieren, dass die Initialisierung beginnt.

pEndHostSetup
[in] Die Funktion, die vom Host aufgerufen wird, um der CLR mitzuteilen, dass die Initialisierung abgeschlossen ist.

Rückgabewert

Diese Methode gibt zusätzlich zu den folgenden Werten die COM-Standardfehlercodes zurück, wie sie in der Datei „WinError.h“ definiert sind.

Rückgabecode	Beschreibung
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Mindestens eines der Argumente ist NULL.

Bemerkungen

Der Host ruft LockClrVersion auf, bevor er die CLR initialisiert. LockClrVersion akzeptiert drei Parameter, die alle Rückrufe vom Typ FLockClrVersionCallback sind. Dieser Typ wird wie folgt definiert.

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Die folgenden Schritte treten bei der Initialisierung der Runtime auf:

Der Host ruft CorBindToRuntimeEx oder eine der anderen Initialisierungsfunktionen für die Runtime auf. Alternativ könnte der Host die Runtime auch über die COM-Objektaktivierung initialisieren.
Die Runtime ruft die durch den Parameter hostCallback angegebene Funktion auf.
Die durch hostCallback angegebene Funktion führt dann die folgende Abfolge von Aufrufen aus:
- Die durch den Parameter pBeginHostSetup angegebene Funktion.
- CorBindToRuntimeEx (oder eine andere Initialisierungsfunktion für die Runtime).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- Die durch den Parameter pEndHostSetup angegebene Funktion.

Alle Aufrufe von pBeginHostSetup bis pEndHostSetup müssen auf einem einzelnen Thread oder einer einzelnen Fiber mit demselben logischen Stapel erfolgen. Dieser Thread kann sich von dem Thread unterscheiden, von dem hostCallback aufgerufen wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: MSCorEE.dll

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch

Veraltete CLR-Hostingfunktionen

Freigeben über