3.3.4.6 TranslateName

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

http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/AccountManagement/TranslateName

This operation is specified by the following WSDL.

 <wsdl:operation name="TranslateName">
     <wsdl:input
         wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/AccountManagement/TranslateName"
         name="TranslateNameRequest"
         message="ca:TranslateNameRequest" />
   <wsdl:output
       wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/AccountManagement/TranslateNameResponse"
       name="TranslateNameResponse"
       message="ca:TranslateNameResponse" />
   <wsdl:fault
       wsam:Action="http://schemas.microsoft.com/2008/1/ActiveDirectory/Data/fault"
       name="TranslateNameFault"
       message=
 "ca:AccountManagement_TranslateName_TranslateNameFault_FaultMessage" />
 </wsdl:operation>

For every string element found in the TranslateNameRequest/Names (section 3.3.4.6.2.5) element array, TranslateName constructs an ActiveDirectoryNameTranslateResult element (section 3.3.4.6.3.1) with all child elements populated, and adds it to the TranslateNameResponse/NameTranslateResult element (section 3.3.4.6.2.7). Upon success, the TranslateNameResponse (section 3.3.4.6.2.6) element is returned.

The number and order of ActiveDirectoryNameTranslateResult elements in the TranslateNameResponse/NameTranslateResult array MUST match the number and order of TranslateNameRequest/Names array elements specified in the request.

If the directory service performing this request is a global catalog, the scope of the name translation includes all domains.

The translation is done using the IDL_DRSCrackNames method ([MS-DRSR] section 4.1.4).

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