3.2.5.3.1 Rules for the wxf:Create Message

A client uses the wxf:Create message to create a RunspacePool on the server, as specified in section 3.1.5.3.3.

Upon receiving this message, the server validates the option with the name "protocolversion" and compares the value of this option against version "2.1" (taken from the table in section 3.1.5.3.1). The server MUST send a wxf:Fault message as described in section 3.2.5.3.2 when any of the following conditions are true:

  • The "protocolversion" option is missing.

  • The major version number of the "protocolversion" option is not equal to 2.

If the validation as described earlier is successful, the server creates a RunspacePool instance, initializes its state to BeforeOpen (section 3.2.1.2.2), and adds it into the WSMV shell to a RunspacePool table (section 3.2.1.1.1). The server MUST then send a wxf:ResourceCreated message (section 3.2.5.3.2).

The wxf:Create message MAY contain "creationXml" data, as described in section 3.1.5.3.3. If "creationXml" data is present in the message, the data will be in base64-encoded format. The server decodes this Base-64 data and processes the message according to the rules described in section 3.2.5.1. If the rules specified in section 3.2.5.1 result in a wxf:Fault message, the server MUST change the RunspacePool state to Broken.