tfDnsUpdateSetSockOpt

Table of Contents >> Application Reference >> Dynamic DNS Update

#include <trsocket.h>

int tfDnsUpdateSetSockOpt	(
	ttDnsUpdateHandle dnsUpdateHandle,
	int protocolLevel,
	int optionName,
	void * optionValuePtr,
	int optionLength
	);

Function Description

Change the characteristics of the underlying socket used by the session. This is a wrapper for setsockopt() and will not be required for most applications.

If you are using the Strong End System Model (configuration macro TM_USE_STRONG_ESL), you can call tfDnsUpdateSetSockOpt() with the SO_BINDTODEVICE to restrict I/O to a specific interface.

Parameters

• dnsUpdateHandle

  A DNS update descriptor handle returned by tfDnsUpdateOpen().

• protocolLevel

  The protocol level at which the option is being set (see setsockopt()).

• optionName

  The name of the option to set (see setsockopt()).

• optionValuePtr

  Pointer to a variable that contains the new value to set.

• optionLength

  The size of the of the option to be set.

Returns

• TM_ENOERROR

  Success.

• TM_EINVAL

  Invalid descriptor handle.

• TM_EPERM

  Cannot change the descriptor while tfDnsUpdateSend() is in progress.

• (more)

  See the setsockopt() page for additional error reasons.

Table of Contents >> Application Reference >> Dynamic DNS Update