3.4.4.1 ChangeOptionalFeature

  • Article

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

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

This operation is specified by the following WSDL.

 <wsdl:operation name="ChangeOptionalFeature">
     <wsdl:input
         wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/ChangeOptionalFeature"
         name="ChangeOptionalFeatureRequest"
         message="ca:ChangeOptionalFeatureRequest" />
   <wsdl:output
       wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/TopologyManagement/ChangeOptionalFeatureResponse"
       name="ChangeOptionalFeatureResponse"
       message="ca:ChangeOptionalFeatureResponse" />
   <wsdl:fault
       wsam:Action="http://schemas.microsoft.com/2008/1/ActiveDirectory/Data/fault"
       name="ChangeOptionalFeatureFault"
       message=
 "ca:TopologyManagement_ChangeOptionalFeature_ChangeOptionalFeatureFault_FaultMessage" />
 </wsdl:operation>

Upon receiving the ChangeOptionalFeature custom action request, the server enables or disables the directory instance feature specified by the ChangeOptionalFeatureRequest/FeatureId (section 3.4.4.1.2.5) element in the naming context (NC) identified by the distinguished name (DN) specified in the ChangeOptionalFeatureRequest/DistinguishedName (section 3.4.4.1.2.3) element. The feature is enabled when the ChangeOptionalFeatureRequest/Enable (section 3.4.4.1.2.4) Boolean element is TRUE, and disabled when the element is either FALSE or not present.

To enable an optional feature, the server writes the rootDSE attribute enableOptionalFeature of the directory instance ([MS-ADTS] section 3.1.1.3.3.28). To disable an optional feature, the server writes the rootDSE attribute disableOptionalFeature of the directory instance ([MS-ADTS] section 3.1.1.3.3.27). In both cases, the content of the write is a string formed from the concatenation of the ChangeOptionalFeatureRequest/DistinguishedName element, a colon (':'), and the contents of the ChangeOptionalFeatureRequest/FeatureId element.

For more information on optional features, see [MS-ADTS] section 3.1.1.9.

Upon success, the server MUST return a ChangeOptionalFeatureResponse message (section 3.4.4.1.1.2) with an empty ChangeOptionalFeatureResponse element (section 3.4.4.1.2.6).

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.1.8.