3.3.4.27 DeleteDNSPTRRecord

The DeleteDNSPTRRecord operation is used to delete the DNS PTR record from the DNS server and update the IPAM data store accordingly.

 <wsdl:operation name="DeleteDNSPTRRecord">
   <wsdl:input wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteDNSPTRRecord" message="ipam:IIpamServer_DeleteDNSPTRRecord_InputMessage" />
   <wsdl:output wsaw:Action="http://Microsoft.Windows.Ipam/IIpamServer/DeleteDNSPTRRecordResponse" message="ipam:IIpamServer_DeleteDNSPTRRecord_OutputMessage" />
 </wsdl:operation>

The protocol client sends an IIpamServer_DeleteDNSPTRRecord_InputMessage request. The server then performs the following processing steps. When the operation completes successfully, the protocol server MUST respond with the IIpamServer_DeleteDNSPTRRecord_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. The following conditions MUST be met:

    • DeleteDNSPTRRecord.address is not NULL.

    • DeleteDNSPTRRecord.address.Address is not NULL.

    • DeleteDNSPTRRecord.address.DnsReverseLookupZoneName is not empty or NULL.

    • DeleteDNSPTRRecord.address.DnsReverseLookupZonePrefix is not NULL.

    • DeleteDNSPTRRecord.address.DnsForwardLookupZoneServerName is not empty or NULL.

  2. DeleteDNSPTRRecord.address.DnsReverseSyncStatus is updated based on the success or failure of the registration on the remote DNS server.

  3. Call the procedure AddOrUpdateAddressDNSReverseLookup in ADM_ AddressDNSReverseLookupTable with parameters as addressfamily (as determined from the instance type of DeleteDNSPTRRecord.address), DeleteDNSPTRRecord.address.RecordId, DeleteDNSPTRRecord.address.DnsZoneID, DeleteDNSPTRRecord.address.DnsReverseLookupZoneDnsServerId, and DeleteDNSPTRRecord.address.DnsReverseLookupZoneId. This procedure returns the RecordId of the newly updated row in ADM_ AddressDNSReverseLookupTable.

  4. Iterate through ADM_DNSResourceRecordTable and delete the rows where RecordType is equal to PTR and IPv4AddressId or IPv6AddressId matches the DeleteDNSPTRRecord.address.RecordId.

  5. The modified DeleteDNSPTRRecord.address is sent in the output message. In case of errors, appropriate errors are returned in DeleteDNSPTRRecordResult for the DNS resource records not deleted.