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:
Call GetUserRoleById of ADM_RoleDefinitionTable by passing DeleteUserRole.roleRecordId as a parameter. Store the returned UserRole object into tempVar.userRole.
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.
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.