RuntimeEnvironment.GetRuntimeInterfaceAsIntPtr(Guid, Guid) Method

Reference

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: RuntimeEnvironment.cs

Source:: RuntimeEnvironment.cs

Source:: RuntimeEnvironment.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Caution

RuntimeEnvironment members SystemConfigurationFile, GetRuntimeInterfaceAsIntPtr, and GetRuntimeInterfaceAsObject are not supported and throw PlatformNotSupportedException.

Returns the specified interface on the specified class.

public:
 static IntPtr GetRuntimeInterfaceAsIntPtr(Guid clsid, Guid riid);

public static IntPtr GetRuntimeInterfaceAsIntPtr (Guid clsid, Guid riid);

[System.Obsolete("RuntimeEnvironment members SystemConfigurationFile, GetRuntimeInterfaceAsIntPtr, and GetRuntimeInterfaceAsObject are not supported and throw PlatformNotSupportedException.", DiagnosticId="SYSLIB0019", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static IntPtr GetRuntimeInterfaceAsIntPtr (Guid clsid, Guid riid);

[System.Runtime.InteropServices.ComVisible(false)]
[System.Security.SecurityCritical]
public static IntPtr GetRuntimeInterfaceAsIntPtr (Guid clsid, Guid riid);

static member GetRuntimeInterfaceAsIntPtr : Guid * Guid -> nativeint

[<System.Obsolete("RuntimeEnvironment members SystemConfigurationFile, GetRuntimeInterfaceAsIntPtr, and GetRuntimeInterfaceAsObject are not supported and throw PlatformNotSupportedException.", DiagnosticId="SYSLIB0019", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member GetRuntimeInterfaceAsIntPtr : Guid * Guid -> nativeint

[<System.Runtime.InteropServices.ComVisible(false)>]
[<System.Security.SecurityCritical>]
static member GetRuntimeInterfaceAsIntPtr : Guid * Guid -> nativeint

Public Shared Function GetRuntimeInterfaceAsIntPtr (clsid As Guid, riid As Guid) As IntPtr

Parameters

clsid: Guid

The identifier for the desired class.

riid: Guid

The identifier for the desired interface.

Returns

IntPtr

nativeint

An unmanaged pointer to the requested interface.

Attributes: ObsoleteAttribute ComVisibleAttribute SecurityCriticalAttribute

Exceptions

COMException

IUnknown::QueryInterface failure.

PlatformNotSupportedException

.NET Core and .NET 5+ only: In all cases.

Remarks

The following table shows the supported combinations for clsid and riid.

`clsid`	`riid`
CLSID_CorMetaDataDispenser	IID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorMetaDataDispenserRuntime	IID_IMetaDataDispenser, IID_IMetaDataDispenserEx
CLSID_CorRuntimeHost	IID_CorRuntimeHost
CLSID_CLRRuntimeHost	IID_CLRRuntimeHost (not valid for the common language runtime that is provided by the .NET Framework 4), IID_CLRRuntimeHost3
CLSID_TypeNameFactory	IID_TypeNameFactory
CLSID_CLRStrongName	IID_CLRStrongName

GetRuntimeInterfaceAsIntPtr is similar to the GetRuntimeInterfaceAsObject method.

Applies to