ICLRRuntimeInfo::GetInterface Method
Loads the CLR into the current process and returns runtime interface pointers, such as ICLRRuntimeHost, ICLRStrongName, ICorDebug, and IMetaDataDispenserEx.
This method supersedes all the CorBindTo* functions in the .NET Framework 1.1 and 2.0 Hosting Global Static Functions section.
HRESULT GetInterface(
[in] REFCLSID rclsid,
[in] REFIID riid,
[out, iid_is(riid), retval] LPVOID *ppUnk);
Parameters
rclsid
[in] The CLSID interface for the coclass.riid
[in] The IID of the requested rclsid interface.ppUnk
[out] A pointer to the queried interface.
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 |
ppUnk is null. |
E_OUTOFMEMORY |
Not enough memory is available to handle the request. |
CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND |
A different runtime was already bound to the legacy CLR version 2 activation policy. |
Remarks
This method causes the CLR to be loaded but not initialized.
The following table shows the supported combinations for rclsid and riid.
rclsid |
riid |
|---|---|
CLSID_CorMetaDataDispenser |
IID_IMetaDataDispenser, IID_IMetaDataDispenserEx |
CLSID_CorMetaDataDispenserRuntime |
IID_IMetaDataDispenser, IID_IMetaDataDispenserEx |
CLSID_CorRuntimeHost |
IID_ICorRuntimeHost |
CLSID_CLRRuntimeHost |
IID_ICLRRuntimeHost |
CLSID_TypeNameFactory |
IID_ITypeNameFactory |
CLSID_CLRDebuggingLegacy |
IID_ICorDebug |
CLSID_CLRStrongName |
IID_ICLRStrongName |
Requirements
Platforms: See .NET Framework System Requirements.
Header: MetaHost.h
Library: Included as a resource in MSCorEE.dll
.NET Framework Versions: 4