Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

3.3.4.5 SetPassword

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

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

This operation is specified by the following WSDL.

 <wsdl:operation name="SetPassword">
     <wsdl:input
         wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/AccountManagement/SetPassword"
         name="SetPasswordRequest"
         message="ca:SetPasswordRequest" />
   <wsdl:output
       wsam:Action=
 "http://schemas.microsoft.com/2008/1/ActiveDirectory/CustomActions/AccountManagement/SetPasswordResponse"
       name="SetPasswordResponse"
       message="ca:SetPasswordResponse" />
   <wsdl:fault
       wsam:Action="http://schemas.microsoft.com/2008/1/ActiveDirectory/Data/fault"
       name="SetPasswordFault"
       message=
 "ca:AccountManagement_SetPassword_SetPasswordFault_FaultMessage" />
 </wsdl:operation>

Upon receiving the SetPassword request, the server sets the password on the principal contained in the SetPasswordRequest/AccountDN element (section 3.3.4.5.2.3), specified by the NC contained in the SetPasswordRequest/PartitionDN element (section 3.3.4.5.2.5). The new password is contained in the SetPasswordRequest/NewPassword element (section 3.3.4.5.2.4). Upon success, the server MUST return a SetPasswordResponse message (section 3.3.4.5.1.3) with an empty SetPasswordResponse element (section 3.3.4.5.2.6).

In the case of AD LDS, the SetPassword custom action sets the value of the user!userPassword or the inetOrgPerson!userPassword attribute of the given security principal. In the case of AD DS, either the user!unicodePwd or the inetOrgPerson!unicodePwd attribute is set. See [MS-ADTS] section 3.1.1.3.1.5 and [MS-SAMR] section 3.1.1.7.2 for additional processing considerations.

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

Show:
© 2015 Microsoft