3.1.5.3.7 Rules for the wxf:Receive Message
The wxf:Receive message (as specified in [MS-WSMV] section 3.1.4.14) is used to notify a server's RunspacePool or pipeline to send PSRP messages to the client using the wxf:ReceiveResponse message (section 3.2.5.3.8). The following information is included in the message.
Element |
Value |
---|---|
ResourceURI |
The Resource URI of the RunspacePool to which this receive message is targeted. For more details, see section 3.1.5.3.3. |
ShellID selector |
The ShellID returned in the wxf:ResourceCreated message (section 3.1.5.3.2).
|
The body of the receive message MUST contain receive complex data type, as described in [MS-WSMV] section 2.2.4.26. The received complex data type MUST contain the following information.
Element |
Value |
---|---|
DesiredStream |
MUST contain a value of "stdout". |
A wxf:Receive message can be sent to a RunspacePool or pipeline. If the wxf:Receive message is targeted to a pipeline it MUST contain the following attribute in the received complex data type.
Element |
Attribute |
Value |
---|---|---|
DesiredStream |
CommandId |
The CommandId returned in the wxf:CommandResponse message (see section 3.1.5.3.4). This attribute MUST NOT be specified if the wxf:Receive message is targeted to RunspacePool. |
If the wxf:Receive message is successfully received and processed by the server, the server MUST send either a success or a failure message. In either case, a response is sent from the server. A wxf:ReceiveResponse message, described in [MS-WSMV] section 2.2.4.27, is sent to notify success. A wxf:Fault message, described in [MS-WSMV] section 2.2.4.43, is sent to notify failure.
Note that no PSRP messages are sent using wxf:Receive.