Export (0) Print
Expand All

Marshal.GetITypeInfoForType Method

Returns a System.Runtime.InteropServices.ComTypes.ITypeInfo interface from a managed type.

Namespace:  System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)

'Declaration
Public Shared Function GetITypeInfoForType ( _
	t As Type _
) As IntPtr

Parameters

t
Type: System.Type

The type whose ITypeInfo interface is being requested.

Return Value

Type: System.IntPtr
A pointer to the ITypeInfo interface for the t parameter.

ExceptionCondition
ArgumentException

t is not a visible type to COM.

-or-

t is a Windows Runtime type.

COMException

A type library is registered for the assembly that contains the type, but the type definition cannot be found.

This method returns a pointer to an ITypeInfo implementation that is based on the original type. Calling an object with GetITypeInfoForType causes the reference count to increment on the interface pointer before the pointer is returned. Always use Marshal.Release to decrement the reference count once you have finished with the pointer. You can apply the System.Runtime.InteropServices.MarshalAsAttribute to replace standard interop marshaling behavior with this custom marshaler.

The following example demonstrates how to retrieve a pointer to the ITypeInfo interface for a type using the GetITypeInfoForType method.

Imports System.Runtime.InteropServices

Module Program


    Sub Run()

        ' Dim a pointer 
        Dim pointer As IntPtr

        Console.WriteLine("Calling Marshal.GetIUnknownForObjectInContext...")

        ' Get the ITypeInfo pointer for an Object type
        pointer = Marshal.GetITypeInfoForType(Type.GetType("System.Object"))

        Console.WriteLine("Calling Marshal.Release...")

        ' Always call Marshal.Release to decrement the reference count.
        Marshal.Release(pointer)



    End Sub 

    Sub Main(ByVal args() As String)

        Run()

    End Sub 

End Module

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

  • SecurityCriticalAttribute 

    requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Show:
© 2015 Microsoft