RemotingServices::GetRealProxy 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 the real proxy backing the specified transparent proxy.

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

public:
[SecurityCriticalAttribute]
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.

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.

SecurityPermission

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

.NET Framework
Available since 1.1
Return to top
Show: