tfDhcpConfGetOption

Table of Contents >> Optional Protocols >> DHCP Automatic Configuration

#include <trsocket.h>

int tfDhcpConfGetOption	(
	ttUserInterface interfaceHandle,
	int index,
	ttUser8Bit bootOption,
	ttUserCharPtr dataPtr,
	ttUser8BitPtr dataLenPtr
	);

Function Description

This function instructs the DHCP client to retrieve a non-native option sent by the DHCP server.

Parameters

• interfaceHandle

  This is the interface handle

• index

  This is the interface's multihome index for which to get the specified option.

• bootOption

  This is the option to be retrieved.

• dataPtr

  This is the buffer used to store the option data.

• dataLenPtr

  This is the maximum size of the dataPtr content. This will be modified upon return to specify the actual amount of the buffer used to store the data.

Returns

• TM_ENOERROR

  This indicates success.

• TM_EINVAL

  This indicates failure. The kernel found invalid arguments in the call.

• TM_ENOBUFS

  This indicates failure due to a failed memory allocation.

• TM_EMSGSIZE

  This indicates failure when the dataPtr is not large enough to hold the option data. dataLenPtr is subsequently modified to the required buffer size.

• TM_ENOENT

  This indicates failure when the specified option is not found.

Usage

This function is used for options not natively supported by the DHCP client. Any unrecognized option sent by the DHCP server can be accessed with this API. This function is for use with the DHCP Automatic Configuration API.

Table of Contents >> Optional Protocols >> DHCP Automatic Configuration