ICLRRuntimeInfo::IsLoaded Method

Article
2021-09-15

Indicates whether the common language runtime (CLR) associated with the ICLRRuntimeInfo interface is loaded into a process. A runtime can be loaded without also being started.

Syntax

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

Parameters

hndProcess
[in] A handle to the process.

pbLoaded
[out] true if the CLR is loaded into the process; otherwise, false.

Return Value

This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULT	Description
S_OK	The method completed successfully.
E_POINTER	`pbLoaded` is null.

Remarks

This method is backward-compatible with the following functions and interfaces:

ICorRuntimeHost interface (in the .NET Framework version 1 hosting API).
ICLRRuntimeHost interface (in the .NET Framework 2.0 hosting API).
Deprecated CorBindTo* functions (see Deprecated CLR Hosting Functions in the .NET Framework 2.0 hosting API).

A host may call one of the deprecated CorBindTo* functions, such as the CorBindToRuntime function, to instantiate a specific version of the CLR. The host could then call the ICLRMetaHost::GetRuntime method and specify the same version number to obtain a ICLRRuntimeInfo interface.

If the host then calls the IsLoaded method on the returned ICLRRuntimeInfo interface, pbLoaded returns true; otherwise, it returns false.

Requirements

Platforms: See System Requirements.

Header: MetaHost.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: Available since 4

Share via