Marshal.GetITypeInfoForType(Type) Method

Reference

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: mscorlib.dll

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.

Returns a ITypeInfo interface from a managed type.

public:
 static IntPtr GetITypeInfoForType(Type ^ t);

public static IntPtr GetITypeInfoForType(Type t);

[System.Security.SecurityCritical]
public static IntPtr GetITypeInfoForType(Type t);

static member GetITypeInfoForType : Type -> nativeint

[<System.Security.SecurityCritical>]
static member GetITypeInfoForType : Type -> nativeint

Public Shared Function GetITypeInfoForType (t As Type) As IntPtr

Parameters

t: Type

The type whose ITypeInfo interface is being requested.

Returns

IntPtr

A pointer to the ITypeInfo interface for the t parameter.

Attributes: SecurityCriticalAttribute

Exceptions

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.

Examples

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

using System;
using System.Runtime.InteropServices;

class Program
{

    static void Run()
    {
        Console.WriteLine("Calling Marshal.GetITypeInfoForType...");

        // Get the ITypeInfo pointer for an Object type
        IntPtr pointer = Marshal.GetITypeInfoForType(typeof(object));

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

        // Always call Marshal.Release to decrement the reference count.
        Marshal.Release(pointer);
    }

    static void Main(string[] args)
    {
        Run();
    }
}

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

Remarks

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.

Applies to

Product	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1

Share via