tf6DhcpUserRegisterAdvOptCb

Jump to: navigation, search

Table of Contents >> Optional Protocols >> DHCPv6


#include <trsocket.h>


int tf6DhcpUserRegisterAdvOptCb (
ttUserInterface interfaceHandle,
tt6DhcpAdvOptCbFuncPtr cbFuncPtr,
ttUser32Bit optFlags
);


Function Description

Set a callback function for the given DHCPv6 options. This function will be called to pass option values from the server’s Advertise message to the user before the DHCPv6 client sends the first Request message to the server. This can be used to change configuration information before sending the Request message to the server. Calling this function will override any previous call. For example, you can register to receive a callback for the FQDN data from the server’s Advertise message. In your callback function, you can then change the FQDN data that will go out in the Request message with tfInterfaceSetOptions() (see the tfInterfaceSetOptions() section for more information). Note: There are no known circumstances in which this capability is currently required. This functionality is being included only as a precaution against hypothetical buggy servers and should be disregarded unless you have specific reasons to use it.


Parameters

  • interfaceHandle
    Handle to the interface from which to retrieve the current RDM value
  • cbFuncPtr
    Pointer to a function to use pass DHCPv6 options to the user. See tt6DhcpAdvOptCbFunc.
  • optFlags
    DHCPv6 options to pass to the callback function. Multiple options must be OR’d together. If multiple options are specified, one call will be made for each option. See below for list of valid options


optFlags

  • TM_6_DHCP_CB_OPT_FQDN
    FQDN option


Returns

  • TM_ENOERROR
    Sucessful
  • TM_EINVAL
    Invalid parameter


Table of Contents >> Optional Protocols >> DHCPv6