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.