addressDeclined

The addressDeclined routine is used for accounting purposes when a DHCP client indicates to the server (through the DHCP DECLINE message type) that the given address is in use on the network.

The routine is called immediately after the database has been instructed to disassociate the client identifier and address binding. If so configured, the routine is called after the DNS server has been indicated to disassociate the name and address binding. Parameters given to the routine are read-only.

The structure of the addressDeclined routine follows:

void addressDeclined ( caddr_t hObjectInstance,
                       const struct dhcpclientid *cid,
                       const struct in_addr *addr,
                       const char *hostname,
                       const char *domain                     ) ;
Where:
Item Description
hObjectInstance Is the same configuration instance handle created when this object was initialized.
cid Is the client identifier of the client.
addr Is the address that was declined by the client.
hostname Is the hostname previously associated with this client and address binding.
domain Is the domain in which the hostname for the client was (or should have been) previously updated.