ReturnMessage Class

 

Holds a message returned in response to a method call on a remote object.

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

System.Object
  System.Runtime.Remoting.Messaging.ReturnMessage

<SecurityCriticalAttribute>
<ComVisibleAttribute(True)>
<SecurityPermissionAttribute(SecurityAction.InheritanceDemand,
	Flags := SecurityPermissionFlag.Infrastructure)>
Public Class ReturnMessage
	Implements IMethodReturnMessage, IMethodMessage, IMessage

NameDescription
System_CAPS_pubmethodReturnMessage(Exception, IMethodCallMessage)

Initializes a new instance of the ReturnMessage class.

System_CAPS_pubmethodReturnMessage(Object, Object(), Int32, LogicalCallContext, IMethodCallMessage)

Initializes a new instance of the ReturnMessage class with all the information returning to the caller after the method call.

NameDescription
System_CAPS_pubpropertyArgCount

Gets the number of arguments of the called method.

System_CAPS_pubpropertyArgs

Gets a specified argument passed to the method called on the remote object.

System_CAPS_pubpropertyException

Gets the exception that was thrown during the remote method call.

System_CAPS_pubpropertyHasVarArgs

Gets a value indicating whether the called method accepts a variable number of arguments.

System_CAPS_pubpropertyLogicalCallContext

Gets the LogicalCallContext of the called method.

System_CAPS_pubpropertyMethodBase

Gets the MethodBase of the called method.

System_CAPS_pubpropertyMethodName

Gets the name of the called method.

System_CAPS_pubpropertyMethodSignature

Gets an array of Type objects containing the method signature.

System_CAPS_pubpropertyOutArgCount

Gets the number of out or ref arguments on the called method.

System_CAPS_pubpropertyOutArgs

Gets a specified object passed as an out or ref parameter to the called method.

System_CAPS_pubpropertyProperties

Gets an IDictionary of properties contained in the current ReturnMessage.

System_CAPS_pubpropertyReturnValue

Gets the object returned by the called method.

System_CAPS_pubpropertyTypeName

Gets the name of the type on which the remote method was called.

System_CAPS_pubpropertyUri

Gets or sets the URI of the remote object on which the remote method was called.

NameDescription
System_CAPS_pubmethodEquals(Object)

Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_protmethodFinalize()

Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetArg(Int32)

Returns a specified argument passed to the remote method during the method call.

System_CAPS_pubmethodGetArgName(Int32)

Returns the name of a specified method argument.

System_CAPS_pubmethodGetHashCode()

Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodGetOutArg(Int32)

Returns the object passed as an out or ref parameter during the remote method call.

System_CAPS_pubmethodGetOutArgName(Int32)

Returns the name of a specified out or ref parameter passed to the remote method.

System_CAPS_pubmethodGetType()

Gets the Type of the current instance.(Inherited from Object.)

System_CAPS_protmethodMemberwiseClone()

Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodToString()

Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_noteNote

This class makes a link demand and an inheritance demand at the class level. A SecurityException is thrown when either the immediate caller or the derived class does not have infrastructure permission. For details about security demands, see Link Demands and Inheritance Demands.

<PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
Public Class MyProxy
   Inherits RealProxy
   Private stringUri As String
   Private myMarshalByRefObject As MarshalByRefObject

   Public Sub New(myType As Type)
      MyBase.New(myType)
      myMarshalByRefObject = CType(Activator.CreateInstance(myType), MarshalByRefObject)
      Dim myObject As ObjRef = RemotingServices.Marshal(myMarshalByRefObject)
      stringUri = myObject.URI
   End Sub 'NewNew

   Public Overrides Function Invoke(myMessage As IMessage) As IMessage
      Dim myCallMessage As IMethodCallMessage = CType(myMessage, IMethodCallMessage)

      Dim myIMethodReturnMessage As IMethodReturnMessage = RemotingServices. _
         ExecuteMessage(myMarshalByRefObject, myCallMessage)

      Console.WriteLine("Method name : " + myIMethodReturnMessage.MethodName)
      Console.WriteLine("The return value is : " + myIMethodReturnMessage.ReturnValue)

      ' Get number of 'ref' and 'out' parameters.
      Dim myArgOutCount As Integer = myIMethodReturnMessage.OutArgCount
      Console.WriteLine("The number of 'ref', 'out' parameters are : " + _
         myIMethodReturnMessage.OutArgCount.ToString())
      ' Gets name and values of 'ref' and 'out' parameters.
      Dim i As Integer
      For i = 0 To myArgOutCount - 1
         Console.WriteLine("Name of argument {0} is '{1}'.", i, _
            myIMethodReturnMessage.GetOutArgName(i))
         Console.WriteLine("Value of argument {0} is '{1}'.", i, _
            myIMethodReturnMessage.GetOutArg(i))
      Next i
      Console.WriteLine()
      Dim myObjectArray As Object() = myIMethodReturnMessage.OutArgs
      For i = 0 To myObjectArray.Length - 1
         Console.WriteLine("Value of argument {0} is '{1}' in OutArgs", i, myObjectArray(i))
      Next i
      Return myIMethodReturnMessage
   End Function 'Invoke
End Class 'MyProxy

SecurityPermission

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

SecurityPermission

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

.NET Framework
Available since 1.1

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top
Show: