Share via

3.4.4.2 GetADDomain

  • Article

A server processes a GetADDomain request using the Active Directory Web Services: Custom Action Protocol upon receiving a SOAP message that contains the GetADDomain SOAP header and that specifies the following URI as the SOAP action:

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

This operation is specified by the following WSDL.

 <wsdl:operation name="GetADDomain">
   <wsdl:input
     wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/GetADDomain"
     name="GetADDomainRequest"
     message="ca:GetADDomainRequest" />
   <wsdl:output
     wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/GetADDomainResponse"
     name="GetADDomainResponse"
     message="ca:GetADDomainResponse" />
   <wsdl:fault
     wsam:Action="http://schemas.microsoft.com/2008/1/ActiveDirectory/Data/fault"
     name="GetADDomainFault"
     message="ca:TopologyManagement_GetADDomain_GetADDomainFault_FaultMessage" />
 </wsdl:operation>

The GetADDomain custom action retrieves information for the domain that contains the directory service specified in the GetADDomainRequest SOAP header Server element. If the Server element specifies an AD LDS instance, the server MUST return a fault as specified in section 3.4.4.2.8.1. Upon success, the server MUST return a GetADDomainResponse with the GetADDomainResponse/Domain element (including child elements) filled in.

If an error occurs while processing this operation, the server MUST return the appropriate SOAP fault for the particular error condition as specified in section 3.4.4.2.8.