Edit

ICLRRuntimeInfo::IsLoaded Method

  • Article

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:

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

See also