LockClrVersion-Funktion

Artikel
09/02/2008

Aktualisiert: November 2007

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.

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	Beschreibung
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Mindestens ein Argument ist NULL.

Hinweise

Der Host ruft vor dem Initialisieren der CLR LockClrVersion auf. LockClrVersion verwendet drei Parameter, bei denen es sich sämtlich um Rückrufe vom Typ FLockClrVersionCallback handelt. 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.idl

Bibliothek: MSCorEE.dll

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

Siehe auch

Weitere Ressourcen

Hosting – Globale statische Funktionen

Freigeben über