LockClrVersion-Funktion

Artikel
08/10/2011

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, Version 4 veraltet.

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

Parameter

hostCallback
[in] Die Funktion, die bei der Initialisierung von der CLR aufgerufen werden soll.
pBeginHostSetup
[in] Die Funktion, die vom Host aufgerufen werden soll, um die CLR darüber zu informieren, dass die Initialisierung beginnt.
pEndHostSetup
[in] Die Funktion, die vom Host aufgerufen werden soll, um die CLR darüber zu informieren, dass die Initialisierung abgeschlossen ist.

Rückgabewert

Diese Methode gibt zusätzlich zu den folgenden Werten COM-Standardfehlercodes wie in WinError.h definiert zurück.

Rückgabecode	Beschreibungen
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Mindestens ein Argument ist NULL.

Hinweise

Der Host ruft LockClrVersion auf, bevor die CLR initialisiert wird. LockClrVersion nimmt drei Parameter, die alle Rückrufe des Typs FLockClrVersionCallback sind. Dieser Typ ist wie folgt definiert:

typedef HRESULT ( __stdcall *FLockClrVersionCallback ) ();

Die folgenden Schritte werden nach Initialisierung der CLR ausgeführt:

Der Host ruft CorBindToRuntimeEx oder eine der anderen CLR-Initialisierungsfunktionen auf. Alternativ könnte der Host die CLR mit COM-Objektaktivierung initialisieren.
Die CLR ruft die vom hostCallback-Parameter angegebene Funktion auf.
Die von hostCallback angegebene Funktion führt dann die folgende Aufrufsequenz aus:
- Die vom pBeginHostSetup-Parameter angegebene Funktion.
- CorBindToRuntimeEx (oder eine andere CLR-Initialisierungsfunktion).
- ICLRRuntimeHost::SetHostControl.
- ICLRRuntimeHost::Start.
- Die vom pEndHostSetup-Parameter angegebene Funktion.

Sämtliche Aufrufe von pBeginHostSetup bis pEndHostSetup müssen auf einem einzigen Thread oder Fiber mit demselben logischen Stapel erfolgen. Es kann sich dabei um einen anderen Thread handeln als der, auf dem hostCallback aufgerufen wird.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: MSCorEE.dll

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Weitere Ressourcen

Hosten globaler statischer .NET Framework 1.1- und 2.0-Funktionen

Freigeben über