3.4.4.5 GetVersion

  • Article

A server processes a GetVersion request using the Active Directory Web Services: Custom Action Protocol upon receiving a SOAP message containing the GetVersion SOAP header and specifying the following URI as the SOAP action:

http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/GetVersion

This operation is specified by the following WSDL.

 <wsdl:operation name="GetVersion">
   <wsdl:input
     wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/GetVersion"
     name="GetVersionRequest"
     message="ca:GetVersionRequest" />
   <wsdl:output
     wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/GetVersionResponse"
     name="GetVersionResponse"
     message="ca:GetVersionResponse" />
   <wsdl:fault
     wsam:Action="http://schemas.microsoft.com/2008/1/ActiveDirectory/Data/fault"
     name="GetVersionFault"
     message="ca:TopologyManagement_GetVersion_GetVersionFault_FaultMessage" />
 </wsdl:operation>

The GetVersion custom action retrieves version information on the Active Directory Web Service: Custom Action Protocol. Upon success, the server MUST return a GetVersionResponse (section 3.4.4.5.2.3) with the GetVersionResponse/VersionMajor (section 3.4.4.5.2.4), GetVersionResponse/VersionMinor (section 3.4.4.5.2.5), and GetVersionResponse/VersionString (section 3.4.4.5.2.6) elements filled in.