Marshal.GetIUnknownForObjectInContext Method (Object)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Returns an IUnknown interface from a managed object, if the caller is in the same context as that object.

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

<SecurityCriticalAttribute>
Public Shared Function GetIUnknownForObjectInContext (
	o As Object
) As IntPtr

Parameters

o
Type: System.Object

The object whose IUnknown interface is requested.

Return Value

Type: System.IntPtr

The IUnknown pointer for the specified object, or null if the caller is not in the same context as the specified object.

This method is the same as GetIUnknownForObject except that it returns null if the caller is not in the same context as the object.

The following example demonstrates how to retrieve an IUnknown interface for a managed object using the GetIUnknownForObjectInContext method.

Imports System.Runtime.InteropServices

Module Program


    Sub Run()

        ' Dim an Integer object
        Dim IntegerObject As Integer = 1

        ' Dim a pointer
        Dim pointer As IntPtr

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

        ' Get the IUnKnown pointer for the Integer object
        pointer = Marshal.GetIUnknownForObjectInContext(IntegerObject)

        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 2.0
Return to top
Show: