Skip to content

Latest commit

 

History

History
87 lines (65 loc) · 2.78 KB

iclrruntimeinfo-getinterface-method.md

File metadata and controls

87 lines (65 loc) · 2.78 KB
Raw
description title ms.date api_name api_location api_type f1_keywords helpviewer_keywords ms.assetid topic_type
Learn more about: ICLRRuntimeInfo::GetInterface Method
ICLRRuntimeInfo::GetInterface Method
03/30/2017
ICLRRuntimeInfo.GetInterface
mscordbi.dll
COM
ICLRRuntimeInfo::GetInterface
GetInterface method [.NET Framework hosting]
ICLRRuntimeInfo::GetInterface method [.NET Framework hosting]
cc7b0e5b-48c3-4509-8ebb-611ddb1f7ec2
apiref

ICLRRuntimeInfo::GetInterface Method

Loads the CLR into the current process and returns runtime interface pointers, such as ICLRRuntimeHost, ICLRStrongName, and IMetaDataDispenserEx.

This method supersedes all the CorBindTo* functions in the Deprecated CLR Hosting Functions section.

Syntax

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

Header: MetaHost.h

Library: Included as a resource in MSCorEE.dll

.NET Framework Versions: [!INCLUDEnet_current_v40plus]

See also