Marshal.GetITypeInfoForType Method (Type)

 

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

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

<SecurityCriticalAttribute>
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.

Exception Condition
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


SecurityCriticalAttribute

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

.NET Framework
Available since 1.1
Return to top
Show: