RemotingServices.GetRealProxy Method (Object)

.NET Framework (current version)

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

Returns the real proxy backing the specified transparent proxy.

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

Syntax

C++

[SecurityCriticalAttribute]
public static RealProxy GetRealProxy(
	object proxy
)

Parameters

proxy: Type: System.Object
A transparent proxy.

Return Value

Type: System.Runtime.Remoting.Proxies.RealProxy

The real proxy instance backing the transparent proxy.

Exceptions

Exception	Condition
SecurityException	The immediate caller does not have infrastructure permission.

A client that uses an object across any kind of remoting boundary is actually using a transparent proxy for the object. The transparent proxy gives the impression that the actual object resides in the client's space. It achieves this by forwarding calls made on it to the real object using the remoting infrastructure.

The transparent proxy is backed by an instance of a managed runtime class of type RealProxy. The RealProxy implements a part of the functionality needed to forward the operations from the transparent proxy.

A proxy object inherits the associated semantics of managed objects such as garbage collection, support for members and methods, and can be extended to form new classes. The proxy acts as an object of the same class as the remote object (transparent proxy), and is also a managed object.

Security

SecurityPermission

for operating with infrastructure code. Demand value: SecurityAction.LinkDemand; Permission value: SecurityPermissionFlag.Infrastructure

Version Information

.NET Framework
Available since 1.1