ICLRMetaHost::EnumerateLoadedRuntimes Method

  • Article

Returns an enumeration that includes a valid ICLRRuntimeInfo interface pointer for each version of the common language runtime (CLR) that is loaded in a given process. This method supersedes the GetVersionFromProcess function.

Syntax

HRESULT EnumerateLoadedRuntimes (  
    [in] HANDLE hndProcess,  
    [out, retval] IEnumUnknown **ppEnumerator  
);

Parameters

hndProcess
[in] The handle of the process to inspect for loaded runtimes.

ppEnumerator
[out] An IEnumUnknown enumeration of ICLRRuntimeInfo interfaces corresponding to each CLR that is loaded by the process.

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 ppEnumerator is null.

Remarks

This method is lists all loaded runtimes, even if they were loaded with deprecated functions such as CorBindToRuntime.

Requirements

Platforms: See System Requirements.

Header: MetaHost.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: Available since 4

See also