2.2.1.1 MessageFlags
The MessageFlags enumeration is used by the BinaryMethodCall (section 2.2.3.1) or BinaryMethodReturn (section 2.2.3.3) records to provide information about the structure of the record. The type of the enumeration is INT32, as specified in [MS-DTYP] section 2.2.22.
The following table is common for both the BinaryMethodCall and BinaryMethodReturn records. The term "Method record" is used in the description when it is applicable to both the records. The term "Call Array record" is used in the description when it is applicable to both MethodCallArray (section 2.2.3.2) and MethodReturnCallArray (section 2.2.3.4).
|
Constant/value |
Description |
|---|---|
|
NoArgs 0x00000001 |
The record contains no arguments. It is in the Arg category. |
|
ArgsInline 0x00000002 |
The Arguments Array is in the Args field of the Method record. It is in the Arg category. |
|
ArgsIsArray 0x00000004 |
Each argument is an item in a separate Call Array record. It is in the Arg category. |
|
ArgsInArray 0x00000008 |
The Arguments Array is an item in a separate Call Array record. It is in the Arg category. |
|
NoContext 0x00000010 |
The record does not contain a Call Context value. It is in the Context category. |
|
ContextInline 0x00000020 |
Call Context contains only a Logical Call ID value and is in the CallContext field of the Method record. It is in the Context category. |
|
ContextInArray 0x00000040 |
CallContext values are contained in an array that is contained in the Call Array record. It is in the Context category. |
|
MethodSignatureInArray 0x00000080 |
The Method Signature is contained in the Call Array record. It is in the Signature category. |
|
PropertiesInArray 0x00000100 |
Message Properties is contained in the Call Array record. It is in the Property category. |
|
NoReturnValue 0x00000200 |
The Return Value is a Null object. It is in the Return category. |
|
ReturnValueVoid 0x00000400 |
The method has no Return Value. It is in the Return category. |
|
ReturnValueInline 0x00000800 |
The Return Value is in the ReturnValue field of the MethodReturnCallArray record. It is in the Return category. |
|
ReturnValueInArray 0x00001000 |
The Return Value is contained in the MethodReturnCallArray record. It is in the Return category. |
|
ExceptionInArray 0x00002000 |
An Exception is contained in the MethodReturnCallArray record. It is in the Exception category. |
|
GenericMethod 0x00008000 |
The Remote Method is generic and the actual Remoting Types for the Generic Arguments are contained in the Call Array. It is in the Generic category.<2> |
The preceding table lists the possible values of the enumeration. The category designation for each value provides the grouping of these values. It is a flags enumeration. However, not all combinations are valid.
To be valid, a MessageFlags value is required to conform to the following:
For each flags category given in the preceding table (Arg, Context, Signature, Return, Exception, Property, and Generic), the value MUST NOT have more than one flag from the Category set.
The Args and Exception flag categories are exclusive: if a flag from the Args category is set, the value MUST NOT have any flag from the Exception category set, and vice versa.
The Return and Exception flag categories are exclusive: if a flag from the Return category is set, the value MUST NOT have any flag from the Exception category set, and vice versa.
The Return and Signature categories are exclusive: if a flag from the Return category is set, the value MUST NOT have any flag from the Signature category set, and vice versa.
The Exception and Signature categories are exclusive: if a flag from the Signature category is set, the value MUST NOT have any flag from the Exception category set, and vice versa.
The following table summarizes the preceding rules.
|
|
Arg |
Context |
Signature |
Return |
Exception |
Property |
Generic |
|---|---|---|---|---|---|---|---|
|
Arg |
Invalid |
Valid |
Valid |
Valid |
Invalid |
Valid |
Valid |
|
Context |
Valid |
Invalid |
Valid |
Valid |
Valid |
Valid |
Valid |
|
Signature |
Valid |
Valid |
N/A |
Invalid |
Invalid |
Valid |
Valid |
|
Return |
Valid |
Valid |
Invalid |
Invalid |
Invalid |
Valid |
Valid |
|
Exception |
Invalid |
Valid |
Invalid |
Invalid |
N/A |
Valid |
Valid |
|
Property |
Valid |
Valid |
Valid |
Valid |
Valid |
N/A |
Valid |
|
Generic |
Valid |
Valid |
Valid |
Valid |
Valid |
Valid |
N/A |
The combination of Signature and Signature, Property and Property, Generic and Generic, or Exception and Exception is not applicable because there is only one bit in the Enum for each of these categories.