Share via


ICLRRuntimeInfo::IsLoaded Method

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.

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 .NET Framework System Requirements.

Header: MetaHost.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: 4

See Also

Reference

ICLRRuntimeInfo Interface

Other Resources

Hosting Interfaces

Hosting (Unmanaged API Reference)