3.1.4.8 AddUserToRole

  • Article

The AddUserToRole operation is used to add the user to a role definition.

 <wsdl:operation name="AddUserToRole">
     <wsdl:input message="tns:AddUserToRoleSoapIn" />
     <wsdl:output message="tns:AddUserToRoleSoapOut" />
 </wsdl:operation>

The protocol client sends an AddUserToRoleSoapIn request message (section 3.1.4.8.1.1), and the protocol server responds with an AddUserToRoleSoapOut response message (section 3.1.4.8.1.2), in the following sequence:

  1. If the specified role definition does not exist, the server MUST return a SOAP fault with the error code 0x80131600.

  2. If the specified login name does not exist or it is not in a valid format, the server MUST return a SOAP fault with the error code 0x81020054. However, when Active Directory account creation mode is enabled, the server responds according to an implementation-specific algorithm.<9>

  3. If the specified role definition is a "Guest" role type, as specified in section 3.1.4.21.3.1, the server MUST return a SOAP fault with the error code 0x80131600.

  4. Otherwise, the server MUST add the user to the specified role definition and MUST respond with an AddUserToRoleSoapOut response message.