2.2.2.16 RUNSPACEPOOL_HOST_RESPONSE Message

  • Article

The Data field of a PSRP message specifies a RUNSPACEPOOL_HOST_RESPONSE message when the MessageType field has a value of 0x00021101.

In messages of this type, the Data field is UTF-8 encoded XML, equivalent to the XML created by serializing a Complex Object (section 2.2.5.2) with the following extended properties (see section 2.2.5.2.9).

  • Call ID

    • Property name: ci.

    • Property type: Signed long (see section 2.2.5.1.13).

  • ID of the host method that the response is coming from

    • Property name: mi.

    • Property type: Host Method Identifier (see section 2.2.3.17).

  • Return value of the method

    • Property name: mr.

    • Property type: Host Parameter Encoding in Host Method Calls (see section 2.2.6).

  • Exception thrown by a host method invocation

    • Property name: me.

    • Property type: ErrorRecord (see section 2.2.3.15). The FullyQualifiedErrorId property SHOULD have a value of "RemoteHostExecutionException".

Note that if either the mr property or the me property is present, the other can be omitted.

The Complex Object described in this section SHOULD have no associated type names (section 2.2.5.2.3).

Example:

 <Obj RefId="11">
   <MS>
     <S N="mr">Line read from the host</S>
     <I64 N="ci">1</I64>
     <Obj N="mi" RefId="12">
       <TN RefId="4">
         <T>System.Management.Automation.Remoting.RemoteHostMethodId</T>
         <T>System.Enum</T>
         <T>System.ValueType</T>
         <T>System.Object</T>
       </TN>
       <ToString>ReadLine</ToString>
       <I32>11</I32>
     </Obj>
   </MS>
 </Obj>