3.1.4.1 Header Processing Rules

  • Article

With the exception of the GetVersion operation, a client MUST include the Server element (section 2.2.3.5) as a SOAP header in all Active Directory Web Services: Custom Action Protocol requests. The client SHOULD set the SOAP mustUnderstand attribute to true on this element.

When the server receives an Active Directory Web Services: Custom Action Protocol request on which the Server element is present as a SOAP header, the server processes the request in accord with Active Directory Web Services: Custom Action Protocol operation(s) as described in this document. Otherwise, the server rejects the request entirely. If the server receives an Active Directory Web Services: Custom Action Protocol request where the SOAP header contains an empty, not present, invalid, null, or unknown Server element, the server returns a SOAP fault corresponding to the Custom Action that was requested as described in sections 3.3.4.1.8.1, 3.3.4.2.8.1, 3.3.4.3.8.1, 3.3.4.4.8.1, 3.3.4.5.8.1, 3.3.4.6.8.1, 3.4.4.1.8.1, 3.4.4.2.8.1, 3.4.4.3.8.1, 3.4.4.4.8.1, and 3.4.4.6.8.1. The interpretation of an invalid or unknown Server element is as follows.

  • A Custom Action Protocol request with a SOAP header containing a Server element that does not conform to section 2.2.3.5 is considered to specify an invalid Server element.

  • A Custom Action Protocol request with a SOAP header containing a Server element that conforms to the format constraints specified in section 2.2.3.5 but fails to identify an instance of a directory service is considered to specify an unknown Server element.