This documentation is archived and is not being maintained.

IObjectHandle Interface

Defines the interface for unwrapping marshal-by-value objects from indirection.

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

[InterfaceTypeAttribute(ComInterfaceType::InterfaceIsIUnknown)]
[GuidAttribute(L"C460E2B4-E199-412a-8456-84DC3E4838C3")]
[ComVisibleAttribute(true)]
public interface class IObjectHandle

The IObjectHandle type exposes the following members.

  NameDescription
Public methodUnwrapUnwraps the object.
Top

Marshal-by-value objects can be returned through an indirection, allowing the caller to control when the object is loaded into their domain. The caller can unwrap the object from the indirection through this interface.

The class implementing the IObjectHandle interface can be used to pass an object (in a wrapped state) between multiple application domains without loading the metadata for the wrapped object in each AppDomain through which the IObjectHandle travels. Thus, the IObjectHandle class gives the caller control of when the Type of the remote object is loaded into their domain.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: