3.3.4.20 DeleteServer

This operation can be used to delete a specific server instance from the IPAM data store.

 <wsdl:operation name="DeleteServer">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteServer" message="ipam:IIpamServer_DeleteServer_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteServerResponse" message="ipam:IIpamServer_DeleteServer_OutputMessage" />
 </wsdl:operation>

Upon receiving the IIpamServer_DeleteServer_InputMessage request message, the server performs the following processing steps. Upon successful completion of the steps specified below, the server MUST respond with the IIpamServer_DeleteServer_OutputMessage message. 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. Enumerate the row in ADM_ServersTable whose RecordId is the same as DeleteServer.serverInfoRecordId.

  2. If there is no such row that meets the specified criteria, an appropriate SOAP fault MUST be generated.

  3. Delete the row in ADM_ServersTable whose RecordId is the same as the DeleteServer.serverInfoRecordId.

  4. Call the procedure DeleteCustomFieldValuesForObject with the following parameters to delete the custom field values associated with the server instance deleted.

    1. Param_ObjectType is set to EnumerationObjectType.ServerInfo.

    2. Param_addressFamily is set to null.

    3. Param_ObjectRecordId is set to DeleteServer.serverInfoRecordId.