3.1.5.1.2 Mapping Remote Method Invocation Reply

The Remote Method invocation reply consists of Return Value, OutputArguments, Exception, and Call Context.

The implementation MAY construct an Array of System.Object classes called Message Properties in order to transmit implementation-specific information to the client. The Array, if constructed, MUST contain items whose Remoting Types are instances of the DictionaryEntry Class as defined in DictionaryEntry (section 2.2.2.6). Each DictionaryEntry item MUST contain the name and the value of the implementation-specific information.<34>

The reply is serialized into the serialization stream by using the records defined in [MS-NRBF], as follows:

A SerializationHeader record as defined in [MS-NRBF] MUST be serialized. Following the SerializationHeader record, the Remote Method invocation reply MUST be serialized using a BinaryMethodReturn record and a MethodReturnCallArray record. The MethodReturnCallArray record is conditional and the rules for the presence of the MethodReturnCallArray record are given in the following table. The table specifies the rules for serializing reply and the values for the MessageEnum field of the BinaryMethodReturn record.

Item name	Condition	MessageEnum bit	Item's serialized location
Return value	None	ReturnValueVoid	-NA-
Return value	Null	NoReturnValue	-NA-
Return value	Primitive Value	ReturnValueInline	ReturnValue field of the BinaryMethodReturn record
Return value	non-Primitive Value	ReturnValueInArray	An item in the MethodReturnCallArray record
Output Argument	None	NoArgs	-NA-
Output Argument	All Primitive	ArgsInLine	Args field of the BinaryMethodReturn record
Output Argument	At least one non-primitive Argument and no Exception, Call Context, or Message Properties	ArgsIsArray	A separate ArraySingleObject record that follows the BinaryMethodReturn record
Output Argumen t	Otherwise	ArgsInArray	An item in the MethodReturnCallArray record
Exception	Absent	0	-NA-
Exception	Present	ExceptionInArray	An item in the MethodReturnCallArray record
Call Context	LogicalCallID Only	ContextInLine	The Call Context field of the BinaryMethodReturn record
Call Context	Otherwise	ContextInArray	An item in the MethodReturnCallArray record
Message Properties	Absent	0	-NA-
Message Properties	Present	PropertiesInArray	An item in the MethodReturnCallArray record

If none of the items in the preceding table ended up in the MethodReturnCallArray record, then the record MUST be not present.

Following this, the Data Value contained in the Return Value, OutputArguments, Exception, Call Context, and Message Properties MUST be serialized. Each node in the Data Value graph MUST be iterated and each node MUST be serialized exactly once as specified in the following sections.