ICLRRuntimeInfo::IsLoaded-Methode

Artikel
08/10/2011

Gibt an, ob die der ICLRRuntimeInfo-Schnittstelle zugeordnete Common Language Runtime (CLR) in einen Prozess geladen wurde. Eine Laufzeit kann geladen werden, ohne auch gestartet zu werden.

HRESULT IsLoaded(
[in]  HANDLE hndProcess,
[out, retval] BOOL *pbLoaded);

Parameter

hndProcess
[in] Ein Handle für den Prozess.
pbLoaded
[out] true, wenn die CLR in den Prozess geladen ist, andernfalls false.

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler für Methodenfehler zurück.

HRESULT	Beschreibungen
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_POINTER	pbLoaded ist NULL.

Hinweise

Diese Methode ist mit den folgenden Funktionen und Schnittstellen abwärtskompatibel:

ICorRuntimeHost-Schnittstelle (in der .NET Framework 1-Hosting-API).
ICLRRuntimeHost-Schnittstelle (in der .NET Framework 2.0-Hosting-API).
Veraltete CorBindTo*-Funktionen (siehe Hosten globaler statischer .NET Framework 1.1- und 2.0-Funktionen in der .NET Framework 2.0-Hosting-API).

Ein Host ruft möglicherweise eine der veralteten CorBindTo*-Funktionen, z. B. die CorBindToRuntime-Funktion, auf, um eine bestimmte Version der CLR zu instanziieren. Der Host kann dann die ICLRMetaHost::GetRuntime-Methode aufrufen und die gleiche Versionsnummer angeben, um eine ICLRRuntimeInfo-Schnittstelle abzurufen.

Wenn der Host dann die IsLoaded-Methode für die zurückgegebene ICLRRuntimeInfo-Schnittstelle aufruft, gibt pbLoaded true zurück. Andernfalls wird false zurückgegeben.