3.3.4.36 DeleteUserRole

The DeleteUserRole operation is used to delete the user role from the IPAM data store.

 <wsdl:operation name="DeleteUserRole">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteUserRole" message="ipam:IIpamServer_DeleteUserRole_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteUserRoleResponse" message="ipam:IIpamServer_DeleteUserRole_OutputMessage" />
 </wsdl:operation>

The protocol client sends an IIpamServer_DeleteUserRole_InputMessage request. The server then performs the following processing steps. When the operation completes successfully, the protocol server MUST respond with the IIpamServer_DeleteUserRole_OutputMessage response. In the event of a failure, an appropriate SOAP fault MUST be sent to the client as specified in section 2.2.2.1:

  1. Call GetUserRoleById of ADM_RoleDefinitionTable by passing DeleteUserRole.roleRecordId as a parameter. Store the returned UserRole object into tempVar.userRole.

  2. If tempVar.userRole is NULL or tempVar.userRole.IsBuiltinRole is TRUE, then a SOAP fault MUST be generated as specified in section 2.2.2.1.

  3. The record associated with the DeleteUserRole.roleRecordId is deleted from ADM_RoleDefinitionTable. A value of 1 is returned if the delete was successful else a value of 0 is returned in the output message.